eesyphp/docs/install.md

Installation

Dependencies :

This Debian packages have to be installed :

• git (only for deployment only)
• composer (and unzip or zip)
• php-cli
• php-mail
• php-mail-mine
• php-net-smtp
• php-auth-sasl
• php-json
• php-mbstring
• php-pgsql (for PostgreSQL DB backend)
• php-sqlite3 (for sqlite DB backend, sqlite3 tool (provided by the same name package) is also used to create the DB file)
• smarty3

Deployment :

To deploy this application, for instance in /var/www/eesyphp, run this commands :

cd /var/www
adduser --home /var/www/eesyphp --no-create-home --disabled-password --gid 33 eesyphp
git clone https://gogs.example.org/example/eesyphp.git /var/www/eesyphp
chown eesyphp: /var/www/eesyphp
ln -s /var/www/eesyphp/bin/items.wrapper /usr/local/bin/eesyphp
ln -s /var/www/eesyphp/docs/eesyphp.cron /etc/cron.d/eesyphp
ln -s /var/www/eesyphp/docs/eesyphplogrotate /etc/logrotate.d/eesyphp

Install PHP dependencies :

su - eesyphp
composer install

Initialize database :

SQLite

To initialize SQLite database, run this commands :

cd /var/www/eesyphp/data
sqlite3 db.sqlite3 < sqlite.init-db.sql

PostgreSQL

To initialize PostgreSQL database, run this commands :

su - postgres
createuser -P items
createdb -O items items
psql items < /var/www/eesyphp/data/pgsql.init-db.sql

MariaDB / MySQL

To initialize MariaDB / MySQL database, run this commands :

sudo mysql << EOF
CREATE DATABASE items;
GRANT ALL ON items.* TO items@localhost IDENTIFIED BY 'items';
EOF
sudo mysql items < /var/www/eesyphp/data/mariadb-mysql.init-db.sql

Configure PHP FPM pool :

You could configure a dedicated PHP FPM pool.

Example :

[eesyphp]
user = eesyphp
group = www-data
listen = /run/php7.0-fpm_eesyphp.sock
listen.owner = www-data
listen.group = www-data
pm = dynamic
pm.max_children = 5
pm.start_servers = 2
pm.min_spare_servers = 1
pm.max_spare_servers = 3
chdir = /
php_value[error_log] = /var/www/eesyphp/data/logs/php.log
php_value[upload_max_filesize] = 10M
php_value[post_max_size] = 10M
php_value[memory_limit] = 10M
php_value[default_charset] = 'UTF-8'
php_value[date.timezone] = Europe/Paris

Configure Apache VirtualHost :

You could configure a dedicated VirtualHost.

Example :

<VirtualHost *:80>
        ServerName eesyphp.example.org
        DocumentRoot /var/www/empty

        RewriteEngine on
        RewriteRule ^/?(.*) https://%{SERVER_NAME}/$1 [R,L]

        ErrorLog  /var/log/apache2/eesyphp.example.org-error.log
        CustomLog /var/log/apache2/eesyphp.example.org-access.log combined
</VirtualHost>

<VirtualHost *:443>
        ServerName eesyphp.example.org
        DocumentRoot /var/www/eesyphp/public_html

        SSLEngine On
        SSLCertificateFile /etc/letsencrypt/live/eesyphp.example.org/fullchain.pem
        SSLCertificateKeyFile /etc/letsencrypt/live/eesyphp.example.org/privkey.pem

        <FilesMatch \.php$>
                SetHandler "proxy:unix:/run/php7.0-fpm_eesyphp.sock|fcgi:///"
        </FilesMatch>

        <Directory   /var/www/eesyphp/public_html>
                # Acceptable overrides:
                # - FileInfo (.htacces-based rewrite rules)
                # - AuthConfig (.htaccess-based basic auth)
                AllowOverride FileInfo AuthConfig
        </Directory>

        # Compress most static files
        AddOutputFilterByType DEFLATE text/html text/xml text/css application/javascript

        ErrorLog  /var/log/apache2/eesyphp.example.org-error.log
        CustomLog /var/log/apache2/eesyphp.example.org-access.log combined
</VirtualHost>