README

FyrePHP is an application skeleton for FyreFramework with application bootstrap, HTTP and CLI entry points, configuration, and a welcome page ready to run. Use it as a starting point for your application: define routes in config/routes.php, add application code under app/, and build pages in templates/.

Getting started
Project structure
Configuration
Hosting
Documentation
Development checks
License

Getting started

Requires PHP 8.5 or later, the intl, mbstring, and sodium extensions, and Composer.

Create a new application with Composer:

composer create-project fyre/app my-app
cd my-app

This creates the project directory and installs its dependencies. If you cloned or downloaded this repository instead, run composer install from the project directory.

Copy the development environment file and start the development server:

cp config/.env.example config/.env
./bin/fyre server

Open http://localhost:8000 to view the welcome page. No database, Redis, or SMTP setup is needed to get started.

The server uses PHP's built-in development server. The port defaults to 8000; use -p to choose a port between 1 and 65535:

./bin/fyre server -p 8080

Use ./bin/fyre server --help to list server options.

Project structure

Path	Purpose
`app/Application.php`	Application bootstrap and middleware configuration.
`config/routes.php`	Route definitions, including the welcome page route.
`config/app.php`	Application and service settings.
`config/bootstrap.php`	Environment loading and global defaults.
`templates/`	Welcome and error page templates.
`public/`	Web document root, including the front controller and public assets.
`tests/TestCase/`	Application tests.

Configuration

Configure application defaults and services in config/app.php. Use config/.env for environment-specific values; config/.env.example lists the available application, database, SMTP, Redis, session, and CSRF settings. Existing process environment variables take precedence over the file.

Session, CSRF, and authentication middleware are optional and can be enabled in app/Application.php after configuring their services. Set a stable CSRF_SALT before enabling CSRF protection, and disable the relevant secure cookie settings when developing over plain HTTP.

Hosting

Set the web server's document root to public/. Ensure tmp/ and log/ exist and are writable by the PHP process; they hold runtime files such as caches, sessions, and logs.

Set APP_DEBUG=0 in production. Use the built-in server for local development only.

Documentation

Continue with the FyreFramework guides:

Development checks

composer cs
composer stan
composer test

Use composer cs:fix to apply the framework's formatting rules.

The test suite contains a smoke test for the welcome page.

License

FyrePHP is released under the MIT License.

fyre / app

Package info

Security

Statistics