Joomla! Framework Site

This application is the code powering the Joomla! Framework website.

Requirements

• PHP 7.2+
  • PDO with MySQL support
• Composer
• Apache with mod_rewrite enabled
• If changing web assets, NPM is required

Installation

1. Clone this repo on your web server
2. Run the composer install command to install all dependencies
3. Copy etc/config.dist.json to etc/config.json and configure your environment (see below for full details on the configuration)
4. Run vendor/bin/phinx migrate to set up the database

Seeding Database

To seed the database with the Framework package data, the following steps should be taken:

1. Run the bin/framework package:sync command, this will load the packages table based on the contents of the packages.yml file at the repository root
2. Run the bin/framework packagist:sync:releases command, this will load the releases table with all stable releases that have been tagged based on the Packagist API response
3. Run the bin/framework packagist:sync:downloads command, this will load the download counts for all packages into the database

Modifying Web Assets

The web assets (CSS, JavaScript, and images) are compiled and processed with Vite. The primary source for all assets is the assets directory, the build is configured in vite.config.mjs and places the production assets into the www/media directory. It also writes www/media/manifest.json, which the application uses to add a cache busting version to the asset URLs.

The use of Vite requires NPM as hinted at in the Installation section. Node 20.19+ or 22.12+ is required. Three scripts are available:

• npm run prod will compile assets for production, which includes compression and minification; code must be committed to this repository with the production configuration
• npm run dev will compile the assets without production optimizations
• npm run watch is the same as the dev script but rebuilds the assets when a source file changes

This site makes use of Subresource Integrity (SRI), therefore the integrity hashes must be regenerated after compiling assets. This can be done by running the bin/framework template:generate-sri command.

Code Style

The PHP code follows PSR-12 with a few additions, configured in .php-cs-fixer.dist.php. Check it with vendor/bin/php-cs-fixer fix --dry-run --diff, or fix all violations with vendor/bin/php-cs-fixer fix. The check runs on every push and pull request.

Database Schema

The database schema is managed through Phinx. The phinx.php file at the root of this repo configures the Phinx environment. Please see their documentation for more information.

Application Configuration

The application's configuration is defined as follows:

• Database - The joomla/database package is used to provide a database connection as required
  • database.host - The address of the database server
  • database.user - The user to connect to the database as
  • database.password - The password for the database user
  • database.database - The name of the database to use
  • database.prefix - The prefix to use for the database's tables
• Template - The twig/twig package is used for the application's templates
  • template.debug - Flag to enable Twig's debug functionality, when enabled the caching functionality is not available
  • template.cache.enabled - Flag to enable Twig's caching functionality
  • template.cache.path - The path relative to the repo root where cached Twig files should be stored
• Logging - The monolog/monolog package is used for logging functionality
  • log.level - The default logging level to use for all application loggers, this defaults to the ERROR level
  • log.application - The logging level to use specifically for the monolog.handler.application logger; defaults to the log.level value
• GitHub - The joomla/github package is used to interface with the GitHub API for some of the site's capabilities
  • gh.token - Set a GitHub API token to use for authenticating to the API, this is the recommended setting
  • api.username - Set the GitHub account username to use for authenticating to the API
  • api.password - Set the GitHub account password to use for authenticating to the API
• Error Reporting - The errorReporting configuration key can be set to a valid bitmask to be passed into the error_reporting() function
• Debug - The debug key allows enabling the application's debug mode, this also makes the PHP Debug Bar available