Fork is an open source CMS written in PHP. Fork's source code is hosted on GitHub. This guide will show you how to install Fork CMS on a fresh Debian 9 Hostazor instance.
Requirements
- PHP 7.1 or higher.
- The following PHP extensions:
cURLlibxmlDOMSimpleXMLSPLPDO(with MySQL driver)mb_stringiconvGD2graphics libraryjsonPCREintl
- MySQL 5.0 or higher.
- Nginx
Check the Debian version.
lsb_release -ds # Debian GNU/Linux 9.4 (stretch) Ensure that your system is up to date.
apt update && apt upgrade -y Install required packages.
apt install -y apt-transport-https sudo curl wget dirmngr Create a new non-root user account with sudo access and switch to it.
adduser johndoe --gecos "John Doe" usermod -aG sudo johndoe su - johndoe NOTE: Replace johndoe with your username.
Set up the timezone.
timedatectl list-timezones sudo timedatectl set-timezone Region/City Step 1 - Install PHP and required PHP extensions, MySQL and Nginx
Debian does not provide the latest PHP version in its default software repositories. We’ll need to add a community maintained third-party repository.
sudo wget -O /etc/apt/trusted.gpg.d/php.gpg https://packages.sury.org/php/apt.gpg echo "deb https://packages.sury.org/php/ $(lsb_release -sc) main" | sudo tee /etc/apt/sources.list.d/php.list sudo apt update Install PHP 7.2 and required PHP extensions.
sudo apt install -y php7.2 php7.2-cli php7.2-fpm php7.2-common php7.2-curl php7.2-mbstring php7.2-gd php7.2-intl php7.2-mysql php7.2-xml php7.2-json Check the version.
php --version PHP 7.2.5-1+0~20180505045740.21+stretch~1.gbpca2fa6 (cli) (built: May 5 2018 04:57:44) ( NTS ) Copyright (c) 1997-2018 The PHP Group Zend Engine v3.2.0, Copyright (c) 1998-2018 Zend Technologies with Zend OPcache v7.2.5-1+0~20180505045740.21+stretch~1.gbpca2fa6, Copyright (c) 1999-2018, by Zend Technologies Step 2 - Install MySQL/MariaDB and setup database
Install MySQL/MariaDB.
sudo apt install -y mysql-server Check MySQL/MariaDB version.
mysql --version # mysql Ver 15.1 Distrib 10.1.26-MariaDB, for debian-linux-gnu (x86_64) using readline 5.2 Run mysql_secure installation script to improve MySQL security and set the password for MySQL root user.
sudo mysql_secure_installation Connect to MySQL shell as the root user.
sudo mysql -u root -p # Enter password Create an empty MySQL database and user for Fork CMS, and remember the credentials.
CREATE DATABASE dbname; CREATE USER 'username'@'localhost' IDENTIFIED BY 'password'; GRANT ALL PRIVILEGES ON dbname.* TO username@localhost; FLUSH PRIVILEGES; EXIT; Step 3 - Install and configure Nginx
Install Nginx.
sudo apt install -y nginx Check the version.
sudo nginx -v # nginx version: nginx/1.10.3 Run sudo vim /etc/nginx/sites-available/fork.conf and configure Nginx for Fork.
server { listen 80; root /var/www/fork; index index.php index.html; server_name example.com; location / { # Checks whether the requested url exists as a file $uri or directory $uri/ in the root, else redirect to /index.php. try_files $uri $uri/ @redirects; } location @redirects { rewrite ^ /index.php; } location ~ \.php$ { try_files $uri =404; include fastcgi_params; fastcgi_pass unix:/var/run/php/php7.2-fpm.sock; # Make sure to doublecheck this! fastcgi_index index.php; fastcgi_read_timeout 60; fastcgi_split_path_info ^(.+\.php)(/.+)$; fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name; } # Don't pollute the logs with common requests location = /robots.txt { access_log off; log_not_found off; } location = /favicon.ico { access_log off; log_not_found off; } # As Fork CMS has the app_root as doc_root, we need to restrict access to a few things for security purposes! location ~* ^/(composer\..*|vendor\/.*|Procfile$|\.git\/.*|src\/Console.*|.*\.gitignore|\.editorconfig|\.travis.yml|autoload\.php|bower\.json|phpunit\.xml\.dist|.*\.md|app\/logs\/.*|app\/config\/.*|src\/Frontend\/Cache\/CompiledTemplates.*|src\/Frontend\/Cache\/Locale\/.*\.php|src\/Frontend\/Cache\/Navigation\/.*\.php|src\/Frontend\/Cache\/Search\/.*|src\/Backend\/Cache\/CompiledTemplates\/.*|src\/Backend\/Cache\/Locale\/.*\.php)$ { deny all; access_log off; log_not_found off; } # Deny access to dot-files. location ~ /\. { deny all; access_log off; log_not_found off; } } A summary of the changes that you will be making are as follows.
- Change the value of the
rootdirective to point to the correct location of your website, such as/var/www/fork. - Change the value of the
server_namedirective to point to your domain name or IP address. - Make sure you check that
fastcgi_passis set correctly.
Save the file and exit.
Activate the new fork.conf configuration by linking the file to the sites-enabled directory.
sudo ln -s /etc/nginx/sites-available/fork.conf /etc/nginx/sites-enabled/ Test the Nginx configuration.
sudo nginx -t Reload Nginx.
sudo systemctl reload nginx.service Step 4 - Download and install Composer
Download Composer dependencies.
sudo apt install -y curl git unzip Download and install Composer, the dependency manager for PHP.
php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');" php -r "if (hash_file('SHA384', 'composer-setup.php') === '544e09ee996cdf60ece3804abc52599c22b1f40f4323403c44d44fdfdd586475ca9813a858088ffbc1f233e9b180f061') { echo 'Installer verified'; } else { echo 'Installer corrupt'; unlink('composer-setup.php'); } echo PHP_EOL;" php composer-setup.php php -r "unlink('composer-setup.php');" sudo mv composer.phar /usr/local/bin/composer Check the version.
composer --version # Composer version 1.6.5 2018-05-04 11:44:59 Step 5 - Download and install Fork CMS via Composer
Create a document root directory.
sudo mkdir -p /var/www/fork Change ownership of the /var/www/fork directory to johndoe.
sudo chown -R johndoe:johndoe /var/www/fork Download the latest stable release of Fork CMS from the command line.
cd /var/www/fork composer create-project forkcms/forkcms . Change ownership of the /var/www/fork directory to www-data.
sudo chown -R www-data:www-data /var/www/fork Edit the app/config/parameters.yml.dist file and set the database information.
sudo vim /var/www/fork/app/config/parameters_install.yml Using your preferred web browser, open your site and follow the Fork CMS installer. After following the installer you should have Fork up and running. To access the Fork admin area just append /private to your site URL.