PHPackages eastoriented/library - 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. eastoriented/library ActiveProject[DevOps & Deployment](/categories/devops) eastoriented/library ==================== A blueprint to setup a develoment environment for library with docker 2671Makefile Since Jan 19Pushed 3y ago3 watchersCompare [ Source](https://github.com/eastoriented/library)[ Packagist](https://packagist.org/packages/eastoriented/library)[ RSS](/packages/eastoriented-library/feed)WikiDiscussions master Synced 3d ago READMEChangelogDependenciesVersions (2)Used By (0) A PHP developement environment based upon docker to create some libraries ========================================================================= [](#a-php-developement-environment-based-upon-docker-to-create-some-libraries) The objective of `eastoriented/library` is to provide a PHP development environment to develop classes using `docker`. It provide some default git files as `.gitignore`, a skeleton for `README.md`, a MIT licence file, a `bin` directory which contains scripts to use `php`, `composer`, `docker-compose` and `atoum` using `docker`. Moreover, it setup a test environment using [`atoum`](http://docs.atoum.org), and it allow the user to switch PHP version easily and update vendor accordingly. And finally, it provide a `Makefile` to execute tests, update vendor, manage version, regenerate autoload and so on. Features -------- [](#features) - Install with one line command; - Setup a PHP development environment using docker, so it is totally independant from software installed on the workstation; - Allow the user to swith PHP version "on the fly" (support PHP 7.1, 7.2, 7.3, 7.4 and 8 out of the box) and automaticaly update `vendor` directory accordingly; - Can tag version automaticaly according to previous version using [semver](https://semver.org); - Setup a test environment using [atoum](http://atoum.org); - Provide configuration file for various CI (currently Github Action, Travis-CI and Gitlab CI); - Setup a pre-commit hook to run unit tests; - Provide docker wrapper for `composer`, `php`, `atoum` and `docker-compose` in the `bin`directory; - Allow the user to make easily releases according to current commit or tag; - Define configuration to transparently use SSH keys with `composer` in a docker context; - Provide support for `.lvimrc` file used by VIM plugin [`localvimrc`](https://github.com/embear/vim-localvimrc); - Initialize a git repository; - Provide default `.gitattributes` and `.gitognore` files; - Provide default MIT licence file; - Provide default README.md; - Provide default VERSION file; - Works on OSX and Linux; - Support custom PHP images out of the box; - Easy to update; - Use `composer` cache directory. Requirements ============ [](#requirements) Requirements to use `eastoriented/library` are: - [docker](https://docs.docker.com/install/); - [GNU Make](https://www.gnu.org/software/make/); - [git](https://git-scm.com). Installation ============ [](#installation) Execute the following command in a terminal: ``` wget -O - https://raw.githubusercontent.com/eastoriented/library/master/install.sh | sh ``` At end of process, you obtains an arborescence which contains all files needed to develop a PHP class: By default, a github action workflow will be defined, but if you want a `.gitlab-ci.yml`, just do: ``` wget -O - https://raw.githubusercontent.com/eastoriented/library/master/install.sh | env WITH_GITLAB=true sh ``` Travis-CI is also supported: ``` wget -O - https://raw.githubusercontent.com/eastoriented/library/master/install.sh | env WITH_TRAVIS=true sh ``` If you use Github Action, you must define `COVERALLS_REPO_TOKEN` as a [repository secret](https://docs.github.com/en/free-pro-team@latest/actions/reference/encrypted-secrets#creating-encrypted-secrets-for-a-repository). If you use [vim](https://www.vim.org) and [localvimrc](https://github.com/embear/vim-localvimrc), you can do: ``` wget -O - https://raw.githubusercontent.com/eastoriented/library/master/install.sh | env WITH_VIM=true sh ``` In this case, you must edit `./.lvimrc` to define PHP namespace, see contents of `.lvimrc` for more informations. And if you want that `composer` has SSH access on some repositories using your SSH credentials, just do: ``` wget -O - https://raw.githubusercontent.com/eastoriented/library/master/install.sh | env WITH_SSH=true sh ``` It's possible to get `docker-compose.yml` and basic Dockerfiles to build custome PHP images (add extensions, etc): ``` wget -O - https://raw.githubusercontent.com/eastoriented/library/master/install.sh | env WITH_PHP_DOCKERFILES=true sh ``` And last but not least, it is possible to mix all `WITH_*` variables: ``` wget -O - https://raw.githubusercontent.com/eastoriented/library/master/install.sh | env WITH_VIM=true WITH_SSH=true WITH_TRAVIS=true sh ``` Update ====== [](#update) To retrive the last version, just do `make vendor/update` and commit all updated files in your git repository. How to use it? ============== [](#how-to-use-it) Just do `make help` in a terminal. Houston, We've got a problem! ============================= [](#houston-weve-got-a-problem) In case of problem, try to reinstall in debug mode: ``` wget -O - https://raw.githubusercontent.com/eastoriented/library/master/install.sh | env WITH_DEBUG=true sh | tee install.log ``` After that, open an [issue](https://github.com/eastoriented/library/issues) and provide contents of file `install.log` Tips ==== [](#tips) The command `eval $(make session)` add the `bin` directory to your path for your current shell session, so you can do `php -v` and `bin/php` will be called transparently. ### Health Score 21 — LowBetter than 19% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity16 Limited adoption so far Community8 Small or concentrated contributor base Maturity33 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. ### Community Maintainers ![](https://www.gravatar.com/avatar/7f5d8c29ba579eb1b08a260038385cf0f21752ac8bd13b65fe7c1f4f876a594d?d=identicon)[mageekguy](/maintainers/mageekguy) --- Top Contributors [![mageekguy](https://avatars.githubusercontent.com/u/457534?v=4)](https://github.com/mageekguy "mageekguy (124 commits)") ### Embed Badge ![Health badge](/badges/eastoriented-library/health.svg) ``` [![Health](https://phpackages.com/badges/eastoriented-library/health.svg)](https://phpackages.com/packages/eastoriented-library) ``` ### 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)