A hard-fork for the exflickr/flamework project updated to work with PHP 8, Smarty 5 and ElasticSearch/OpenSearch in addition to MySQL.
This is a hard-fork for the exflickr/flamework project updated to work with PHP 8, Smarty 5 and ElasticSearch/OpenSearch in addition to MySQL. It also includes libraries and web pages for managing an OAuth2-based API and access tokens.
This code has been updated to work with PHP 8.4 or higher and Smarty 5.5 or higher.
Documentation is incomplete. For the time have a look at the [docs](docs} folder.
- Design Philosophy
- Database Model
- Install (for
dnfbased systems) - Known Gotchas and Fixes for SELinux
Before deploying a Flamework application you will still need to perform the following tasks manually:
- Configuring MySQL database schemas and users. See Database Model and schema/*.schema for details.
- Creating a new
www/include/secrets.phpfile with the MySQL database and other credentials. See www/include/secrets.php.example for details.
Historically, flamework applications have been deployed as part of a standard LAMP-stack running under the Apache HTTP server. There is an example VirtualHost setup in httpd/flamework.conf.
There is still-experimental work to run the flamework application provided by this repository under a FrankenPHP server. "Experimental" as in: It works but there may still be bugs, or other gotchas, which haven't been accounted for yet. The PHP used by FrankenPHP is very strict about warnings and errors which is good because it will help track down things which need to be updated (in this package) but also not-so-good because it might lead to otherwise non-critical problems triggering errors and slowing down development time.
Under the hood the FrankenPHP application is using the Caddy webserver and there is an example Caddyfile configuration file in frankenphp/Caddyfile.
The details of installing FrankenPHP are outside the scope of this document but once you have you can test Flamework by running:
$> frankenphp run --config frankenphp/Caddyfile
And then when you open your web browser to http://localhost you should see something like this:
In May 2025, the PHP Foundation announced that it would officially support the FrankenPHP project.