virtual_host.md

Adding a Virtual Host

In order to access the PHP Censor web interface, you need to set up a virtual host in your web server.

Below are a few examples of how to do this for various different web servers.

Nginx Example

server {
        ... standard virtual host ...

        location / {
                try_files $uri @php-censor;
        }

        location @php-censor {
                # Pass to FastCGI:
                fastcgi_pass    unix:/path/to/phpfpm.sock;
                fastcgi_index   index.php;
                fastcgi_buffers 256 4k;
                include         fastcgi_params;
                fastcgi_param   SCRIPT_FILENAME $document_root/index.php;
                fastcgi_param   SCRIPT_NAME index.php;
        }
}

Apache Example

For Apache, you can use a standard virtual host, as long as your server supports PHP. All you need to do is add the following to a .htaccess file in your PHP Censor /public directory.

<IfModule mod_rewrite.c>
    RewriteEngine On
    RewriteBase /
    RewriteCond %{REQUEST_FILENAME} !-f
    RewriteCond %{REQUEST_FILENAME} !-d
    RewriteRule . /index.php [L]
</IfModule>

• Edit virtual host in apache2.

<VirtualHost *:80>
    ServerAdmin [email protected]
    DocumentRoot /var/www/php-censor.local/public
    ServerName php-censor.local

    <Directory /var/www/php-censor.local/public/>
        Options Indexes FollowSymLinks
        AllowOverride All
        Require all granted
    </Directory>
    ErrorLog ${APACHE_LOG_DIR}/php-censor-error_log
    CustomLog ${APACHE_LOG_DIR}/php-censor-access_log combined
</VirtualHost>

• Add in /etc/hosts

127.0.0.1   php-censor.local

Built-in PHP Server Example

You can use the built-in PHP server php -S localhost:8080 by adding public/routing.php.

<?php

if (file_exists(__DIR__ . '/' . $_SERVER['REQUEST_URI'])) {
    return false; // serve the requested resource as-is.
} else {
    include_once 'index.php';
}