raphhh/php-app-bootstrap

A bootstrap for a web application, including basic common files and settings

1.0.0 2015-04-05 19:59 UTC

Requires

• php: >=5.4

Requires (Dev)

• phpunit/phpunit: @stable

MIT

• Raphaël Lefebvre

• bootstrap
• samurai

README

A bootstrap for a web application in PHP. Don't set, just code!

About

This bootstrap will install all the basic files and settings to start a PHP web application.

This assumes you'll use Git for vcs, Composer for dependencies, PHPUnit for testing, Travis and Scrutinizer for integration servers.

Files architecture

├── public
|   ├── .htaccess
|   ├── index.php
|   └── robots.txt
├── src
|   └── Dummy.php
├── tests
|   └── DummyTest.php
├── vendor
├── .editorconfig
├── .gitattributes
├── .gitignore
├── .scrutinizer.yml
├── .travis.yml
├── composer.json
├── composer.lock
├── LICENSE
├── phpunit.xml.dist
├── README.md
└── run

• "public" is the web entry point.
• "src" contains all your PHP code.
• "tests" contains all your PHP tests. See PHPUnit for more information.
• "vendor" contains all your PHP dependencies. See Composer for more information.

Installation

With Samurai (recommended)

Just execute Samurai with 'app' bootstrap.

$ samurai new app

With Composer

First, execute Composer to create your project.

$ composer create-project raphhh/php-lib-bootstrap path/to/my/project

Go into your project.

$ cd path/to/my/project

Then, you need to replace composer.json with your specific info.

Usage

Launch unit tests

This bootstrap is configured to use PHPUnit. To run the tests, cd to your project and enter the following command in your console:

$ vendor/bin/phpunit

Launch app in the browser

The public entry point of the application is the dir "public". To run the app, cd to your project and enter the following command in your console:

$ run

This command will launch for you the PHP internal server. Then, open your browser and go to http://localhost:8080/