You can also run Phproject in a Docker container to make the environment setup easier.
The installation process for Phproject should be reasonably simple compared with other project management systems.
If you have command-line access to the project files, you can complete the installation via command-line rather than through the web UI. This can be helpful for automating the site setup, for example if you need multiple sites or are building automated test environments.
php install.php \
--site-url=https://phproject.example.com/ \
--site-name="Example Site" \
--db-user=phproject \
--db-name=example \
--admin-username=admin \
--admin-email=admin@example.com \
--admin-password="secret!"
The --site-url
argument must be the complete URL used to access the site, including the protocol and a trailing slash.
Note that this requires the CLI user to have write permissions to the Phproject installation directory, so it may be best to use with e.g. sudo -u www-data
.
Use -h
or --help
to see all available arguments:
php install.php --help
If you are installing directly from the Git repository, rather than a release .zip, you’ll need to manually install your Composer dependencies before completing the installation:
git clone https://github.com/Alanaktion/phproject.git
cd phproject
composer install
Once installed, many additional options for configuring your site can be found in the Administration panel, under the Configuration tab. Advanced users can add entries to the config
database table to modify additional configuration.
To see performance information and additional details about errors, add a DEBUG
entry to config.php
. This option supports levels 0-3, with 3 being the most verbose.
You should always use 0 in a production environment!
Phproject is designed to be fast, but you can still increase performance by installing an opcode caching layer like APC. Using APC also greatly increases the speed of temporary cached data, including minified code and heavy, cacheable database queries.
If you installed Phproject with git, simply run git pull
to update. Otherwise, updates can be manually installed by downloading the latest release and extracting it over your existing installation.
If there is a change to the database needed after you’ve updated, you will see an alert in the Administration on your Phproject installation, and can update the database from there.
If something breaks after updating, clearing the APC cache or emptying the tmp/cache/
directory will usually solve the problem.