Using php in-built server

luceos

For those familiar with Laravel, it has this nitfy ability to run the application with the PHP built-in server. If your (local) development machine has PHP installed you can already run Laravel. The "only" thing you need for this is a little proxy script that redirects calls to the php files, eg the nginx/apache rewrite rules.

I've written a small script to allow the same behavior for Flarum. Simply create a php file in your Flarum root directory called server.php and add the following contents:

<?php

$uri = urldecode(
    parse_url($_SERVER['REQUEST_URI'], PHP_URL_PATH)
);

if (preg_match('/^\/api/', $uri)) {
    require_once __DIR__ . '/api.php';
}
elseif (preg_match('/^\/admin/', $uri)) {
    require_once __DIR__ . '/admin.php';
}
elseif ($uri !== '/' && file_exists(__DIR__.$uri)) {
    return false;
} else {
    require_once __DIR__ . '/index.php';
}

Now simply run using php -S localhost:8000 server.php, open your browser at http://localhost:8000 and make sure your config reads that url too and you're set.

Please understand this is for development only and you still have to get a MySQL database available.

XEngine

There is also an alternative for using flarum with Laravel Valet. (OSX only Solution)

Create a file named FlarumValetDriver.php in "~/.valet/Drivers" folder and put below codes in it. Restart your valet server. Profit.

AmauryPi

There was already a tutorial for this, but thanks anyway, it really eases the testing of Flarum ? .

luceos

AmauryPi oops I forgot about that one ?

luceos

This is an improved Valet driver ready for future versions of Flarum (which drop api.php and admin.php):

<?php

class FlarumValetDriver extends ValetDriver
{
    /**
     * Determine if the driver serves the request.
     *
     * @param  string  $sitePath
     * @param  string  $siteName
     * @param  string  $uri
     *
     * @return bool
     */
    public function serves($sitePath, $siteName, $uri)
    {
        return is_dir($sitePath.'/vendor/flarum/core') && file_exists($sitePath.'/flarum');
    }
    /**
     * Determine if the incoming request is for a static file.
     *
     * @param  string  $sitePath
     * @param  string  $siteName
     * @param  string  $uri
     *
     * @return string|false
     */
    public function isStaticFile($sitePath, $siteName, $uri)
    {
        if ($this->isActualFile($staticFilePath = $sitePath.$uri)) {
            return $staticFilePath;
        }

        return false;
    }
    /**
     * Get the fully resolved path to the application's front controller.
     *
     * @param  string  $sitePath
     * @param  string  $siteName
     * @param  string  $uri
     *
     * @return string
     */
    public function frontControllerPath($sitePath, $siteName, $uri)
    {
        if (strpos($uri,'/admin') === 0 && file_exists($sitePath.'/admin.php')) {
            return $sitePath.'/admin.php';
        }
        if (strpos($uri,'/api') === 0 && file_exists($sitePath.'/api.php')) {
            return $sitePath.'/api.php';
        }

        return $sitePath.'/index.php';
    }
}