Installation in subdirectory

greektranslator

I have read these
https://docs.flarum.org/install
https://discuss.flarum.org/d/26070-installing-flarum-in-a-folder

But still it is not clear to me. As I understand, non-public content files should be below webroot for extra security, correct? Given that, what are the exact steps to install/configure in a /forum subdirectory (when the actual TLD path is occupied by a CMS)?

For example

/home/mysite/public_html/[CMS files and location]
/home/mysite/public_html/forum/[path to access Flarum (I.e. mysite.com/forum goes to Flarum]

Should I create a folder /home/mysite/flarum
Run in that folder composer create-project flarum/flarum

Then go to the TLD site's htaccess /home/mysite/public_html/.htaccess

And add

<Directory "/home/mysite/forum">
    AllowOverride All
</Directory>

<Directory "/home/mysite/forum/public">

(I want people to access Flarum by going to mysite.com/forum)

clarkwinkelmann

You can follow https://docs.flarum.org/install/#customizing-paths to convert the Flarum "skeleton" application into a "conventional" PHP application. After this step is performed, you can install Flarum in a subfolder just like you would install Wordpress or other CMSes in a subfolder. When using that method, the sensitive files are protected by the Apache htaccess file or nginx rewrite rules instead of being placed outside of the web root.

It's also possible to modify the skeleton application so the sensitive files are at a completely different place on the filesystem but this is not described in the documentation and I don't recommend using this method for non-power users.

greektranslator

If I get this right, that means going to

/home/mysite/public_html/forum/

And installing there
Then moving all /public files to forum directory
Uncommenting lines in .htaccess

Edit $site = require './site.php'; to `$site = require './forum/site.php';

Edit the site.php and update the paths to these?

'base' => /home/mysite/public_html/forum/,
'public' => /home/mysite/public_html/forum/,
'storage' => '/home/mysite/public_html/forum/storage',

clarkwinkelmann

greektranslator the official guide shows how to modify the paths to be relative paths (starting with __DIR__ which points to the directory of the current file) which will work anywhere. When using relative paths the /forum/ part will usually not be visible since it's the already the current folder itself.

Using absolute paths like you did should also work. But it'll need an update if you move the folder later or move to a different server where the web root is in a different location on disk.

$site = require './site.php'; should be the correct value, since index.php and site.php are now in the same folder.