earthit / php-template-project
PHP Template Project
Requires
- php: ^5.2
- doctrine/dbal: ^2.4
- earthit/cmip-rest: ^0.16.4
- earthit/dbc: ^1.1.0
- earthit/paxml: ^1.2.1
- earthit/php-common: ^1.1.0
- earthit/php-project-utils: ^0.1.3
- earthit/schema: ^1.1.1
- earthit/storage: ^0.4.1
- ryprop/nife: ^0.2.4
- swiftmailer/swiftmailer: ~5.4
- togos/action: ^1.0.0
- togos/base32: ^1.0.1
- togos/php-n2r: ^0.1.3
- togos/tpfetcher: ^0.0.7
Requires (Dev)
- phpunit/phpunit: ~3.7
This package is auto-updated.
Last update: 2024-12-20 04:28:22 UTC
README
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:
Folder structure
composer.json
- PHP package and dependency information, used by Composer.package.json
- Node package and dependency information, used by NPM.init-*.php
- Scripts to initialize global state in PHP.src/db-migrations/
- Database scriptsupgrades/
- Upgrades to be run in order to build the schematest-data/
- Run interleaved with upgrades for additional unit test data- miscellaneous handy scripts
src/
- Source code for this project.main/
- Primary application code, broken down by languagetest/
- Unit testsviews/
- View templates
build/
and/ortarget/
- Compiled stuff. Not checked in.node_modules/
- External node libraries, managed my NPM.vendor/
- External PHP libraries, managed by Composer.config/
- Deployment configuration.www/
- Serves as the 'document root' for your project. Contains files to be served directly and a.htaccess
andbootstrap.php
to handle paths that don't correspond to existing files.Vagrantfile
- configuration file for Vagrant.vm-files/
- files to be imported into the vagrant Virtual machine.provision.sh
- Virtual machine provisioning script.
Note that the src/<component>/<language>
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.
build/
and target/
are basically the same thing.
Within one project you should probably pick one or the other and stick with it.
target
is a Maven convention. C and JavaScript people like to call it build
.
Database
Create the database
If you're using Vagrant, don't do this. Just vagrant up
and you
should be good to go. The following only applies if you want to run
outside of Vagrant.
make create-database
will attempt to create the database for you
based on configuration in config/dbc.json
.
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
(sudo -u postgres psql
often does the trick)
and running:
CREATE DATABASE phptemplateprojectdatabase; CREATE USER phptemplateprojectdatabaseuser WITH PASSWORD 'phptemplateprojectdatabasepassword'; GRANT ALL PRIVILEGES ON DATABASE phptemplateprojectdatabase TO phptemplateprojectdatabaseuser;
If you've changed the name of the database or user in
config/dbc.json
, 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 make rebuild-database
, which will empty
the database and rebuild it from the upgrade scripts.
Rebuilding The Database
Run make rebuild-database
to empty the database and rebuild it from the upgrade scripts in src/db-migrations/upgrades/
.
Run make rebuild-database-with-test-data
to rebuild-database the database and also adddata from src/db-migrations/test-data/
.
Upgrading The Database
Run make upgrade-database
to run newly made upgrade scripts in src/db-migrations/upgrades/
.
Unit Testing
All tests are in src/test/
The structure of src/test/
should mimic that of src/main/
, where a single test file tests a single application file.
To run PHPUnit tests, run make run-tests
.
This will run both unit and integration tests.
Run make run-unit-tests
to just run unit tests and make run-integration-tests
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.
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.