Download the PHP package earthit/php-template-project without Composer

PHP Template Project Technical Documentation

This README was automatically generated by PHPProjectInitializer. If this paragraph is still present it probably means nobody's bothered to write any project-specific documentation, yet.

See also:

• PHP Application Architecture
• Tutorials
  • Make a simple page
• Upgrading from the template project

Folder structure

• • PHP package and dependency information, used by Composer.
• • Node package and dependency information, used by NPM.
• • Scripts to initialize global state in PHP.
• • Database scripts
  • • Upgrades to be run in order to build the schema
  • • Run interleaved with upgrades for additional unit test data
  • miscellaneous handy scripts
• • Source code for this project.
  • • Primary application code, broken down by language
  • • Unit tests
  • • View templates
• and/or - Compiled stuff. Not checked in.
• • External node libraries, managed my NPM.
• • External PHP libraries, managed by Composer.
• • Deployment configuration.
• • Serves as the 'document root' for your project. Contains files to be served directly and a and to handle paths that don't correspond to existing files.
• • configuration file for Vagrant.
• • files to be imported into the vagrant Virtual machine.
• • Virtual machine provisioning script.

Note that the directory is a Maven convention. It's verbose, but gives enough information to keep projects with multiple languages and components (unit tests, build system, runtime, etc) organized.

and are basically the same thing. Within one project you should probably pick one or the other and stick with it. is a Maven convention. C and JavaScript people like to call it .

Database

Create the database

If you're using Vagrant, don't do this. Just and you should be good to go. The following only applies if you want to run outside of Vagrant.

will attempt to create the database for you based on configuration in .

If that fails (due to e.g. your system is not set up in a way for which that script is designed) you can create the database yourself:

Set up a new postgres database by logging in as root ( often does the trick) and running:

If you've changed the name of the database or user in , make the corresponding changes to the above SQL.

Initialize the database

Once a database exists and permissions are set up for our user, you should be able to run , which will empty the database and rebuild it from the upgrade scripts.

Rebuilding The Database

Run to empty the database and rebuild it from the upgrade scripts in .

Run to rebuild-database the database and also adddata from .

Upgrading The Database

Run to run newly made upgrade scripts in .

Unit Testing

All tests are in

The structure of should mimic that of , where a single test file tests a single application file.

To run PHPUnit tests, run . This will run both unit and integration tests. Run to just run unit tests and to just run integration tests.

Integration tests are ones that use the database.

PHP Styles

Follow the conventions used by existing Phrebar code. Namely, tabs for leading indentation, opening brackets on the same line for functions and control structures.

(It may be that 'tabs for leading indentation' and 'Smart Tabs' refer to the exact same practice.)

Deploying

Deployment to the various environments is handled automatically by CircleCI. Read these docs about how Earthling has set up CircleCI.

Web serving

If you're using Vagrant, you can just HTTP to whatever IP address you told Vagrant to use. e.g.

http://192.168.250.250/

If you accepted the default.

If you are running Apache (and Postgres, and other required programs) on your development machine, and this directory is checked out somewhere under the DocumentRoot or an Alias, you may be able to just browse to the www directory and have things work. For me, that's

http://my-local-machine/~my-username/proj/PHPTemplateProject/www/

Most people probably need to run Vagrant though.