PHPackages fkde/aspx - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [DevOps & Deployment](/categories/devops) 4. / 5. fkde/aspx ActiveLibrary[DevOps & Deployment](/categories/devops) fkde/aspx ========= Transform your existing PHP application into a deployable docker container in seconds. v1.0.0(1y ago)07MITPHPPHP >7.4CI failing Since Nov 23Pushed 10mo ago1 watchersCompare [ Source](https://github.com/fkde/aspx-composer)[ Packagist](https://packagist.org/packages/fkde/aspx)[ RSS](/packages/fkde-aspx/feed)WikiDiscussions main Synced 1mo ago READMEChangelog (1)Dependencies (3)Versions (2)Used By (0) About this package ================== [](#about-this-package) Transform your existing PHP Application into a deployable docker container based on Alpine Linux. What you'll get =============== [](#what-youll-get) - PHP 8.3 - Nginx 1.26.2 - Curl ### PHP Modules [](#php-modules) - php83-fpm - php83-json - php83-ldap - php83-curl - php83-phar - php83-pdo - php83-iconv - php83-mbstring - php83-pdo\_mysql - php83-simplexml - php83-dom - php83-ctype - php83-tokenizer - php83-xml - php83-xmlwriter - php83-session - php83-pecl-xdebug Everything together is just as big as ~92.4Mb, which makes it ideal for fast and storage friendly CI/CD Pipelines. With npm and Node.js installed it is barely reaching ~150Mb. Requirements ============ [](#requirements) - Linux (Windows is coming soon, WSL is working fine) - PHP (maybe removed as a requirement in the future) - Docker - Make Installation ============ [](#installation) Composer -------- [](#composer) ``` $> composer require fkde/aspx --dev ``` From your application root, call the following command: ``` $> ./vendor/bin/aspx install ``` After a few seconds you should be informed about the container being started. You should now be able to call in your favorite browser. When the installation finished you will notice a few changes in your project. There should be several new files and a folder added. ### Added files [](#added-files) EntityDescription**docker/:**This folder contains your container definition. You can change anything you want and just run `make install` again afterward.**docker-compose.yml**This file contains the service definitions for docker.**.env:**Is created only when there is no .env present.**Makefile:**This file provides a set of useful helpers, like a switch for Xdebug. Fore more information, take a look at the origin of this project: You are now theoretically able to develop your application within Docker. Practically, you'll probably need a database to store your visitors' data. Attaching a Database ==================== [](#attaching-a-database) We can utilize the `docker-compose.yml` to get a database attached. Just uncomment the additional service and provide your credentials in the .env file. If you had your own .env file before, just add the required variables to it. Usage ===== [](#usage) ### Connect to the container [](#connect-to-the-container) ``` $> make ssh ``` ### Activate Xdebug [](#activate-xdebug) ``` $> make xdebug-on ``` Deactivate with: ``` $> make xdebug-off ``` How does this all work? ======================= [](#how-does-this-all-work) ### Mount [](#mount) Your application is being mounted into the container and is then held in sync by Docker. Inside the container the path is `/var/www`, which is also the directory Nginx is pointing to. ### Permissions [](#permissions) While building the container, a user is being created inside which is getting the same uid as your user. This means, everything being created by the container is handled as if it was you. That will reduce errors regarding different user permissions to nearly zero. FAQ === [](#faq) ### Why do I need PHP on my Host Machine installed? [](#why-do-i-need-php-on-my-host-machine-installed) As this is a Composer package, and Composer itself depends on PHP this is something which is not that easy to achieve. However, it is planned to remove this dependency in the future by using another docker container with only php and composer to get the initial setup done. ### Is it possible to run Laravel with this setup? [](#is-it-possible-to-run-laravel-with-this-setup) Yes of course, Laravel works like a charm with this setup. Just keep in mind that you need to have npm and NodeJS somewhere installed. It is possible to do that in the container though. It also decreases the resulting image size significantly (~124Mb instead of ~1.66Gb) ### What does ASPX mean? [](#what-does-aspx-mean) ASPX is nearly an acronym and stands for **A**lpine **S**upervisor **P**HP Ngin**X**. ### Health Score 25 — LowBetter than 37% of packages Maintenance47 Moderate activity, may be stable Popularity4 Limited adoption so far Community7 Small or concentrated contributor base Maturity38 Early-stage or recently created project Bus Factor1 Top contributor holds 100% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Unknown Total 1 Last Release 540d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/f5d2bd3eecc9c3949d3caf98c4876c8e44c0c73fc80dbc65b55f4d91a5b63eae?d=identicon)[floknapp](/maintainers/floknapp) --- Top Contributors [![FloKnapp](https://avatars.githubusercontent.com/u/3774820?v=4)](https://github.com/FloKnapp "FloKnapp (15 commits)") ### Code Quality TestsPHPUnit ### Embed Badge ![Health badge](/badges/fkde-aspx/health.svg) ``` [![Health](https://phpackages.com/badges/fkde-aspx/health.svg)](https://phpackages.com/packages/fkde-aspx) ``` ### Alternatives [deployer/deployer Deployment Tool 11.0k25.4M207](/packages/deployer-deployer)[appwrite/server-ce End to end backend server for frontend and mobile apps. 55.3k84.2k](/packages/appwrite-server-ce)[pragmarx/health Laravel Server & App Health Monitor and Notifier 2.0k1.0M2](/packages/pragmarx-health)[felixfbecker/language-server-protocol PHP classes for the Language Server Protocol 22476.7M6](/packages/felixfbecker-language-server-protocol)[heroku/heroku-buildpack-php Toolkit for starting a PHP application locally, with or without foreman, using the same config for PHP and Apache2/Nginx as on Heroku 8161.3M10](/packages/heroku-heroku-buildpack-php)[tiamo/phpas2 PHPAS2 is a php-based implementation of the EDIINT AS2 standard 4674.7k](/packages/tiamo-phpas2) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)