This repository provides Docker images for LAMP stack (Linux, Apache, MariaDB, and PHP-FPM).

It is designed to simplify the deployment of PHP applications with a robust and modern environment, offering both Development and Production versions to meet different deployment needs.

The images are built on top of other modular images from the fbraz3 ecosystem, ensuring flexibility, maintainability, and ease of use.

We also provide an AI generated DeepWiki Page with more technical information.

For a complete list of available images, please visit the PHP System Docs page.

• Braz LAMP Docker Image
  • Image Versions
  • Tags
  • Flavors
  • How to Use
    • Development Version
    • Production Version
  • Custom SQL Scripts
  • Security Considerations
  • Environment Variables
  • Manage PHP Directives via Environment Variables
  • Cronjobs
  • Sending Mails
  • Contribution
  • Donation
  • License

This project provides two distinct versions for different use cases:

• Purpose: Designed for local development and testing
• Features:
  • MariaDB with no root password (empty password)
  • phpMyAdmin accessible at /pma/ endpoint
  • Relaxed security settings for ease of development
  • Direct database access without authentication

• Purpose: Optimized for production environments
• Features:
  • MariaDB with mandatory root password configuration
  • Enforced password security: Container will fail to start if using default password
  • Custom SQL scripts support: Execute custom SQL files at startup
  • No phpMyAdmin included for security
  • Secure database configuration
  • Root password configurable via environment variables
  • Anonymous users and test databases removed
  • Enhanced security settings

The image follows a consistent tagging scheme:

• Production: fbraz3/lamp:{php_version} (e.g., 8.2, 8.3, 8.4)
• Development: fbraz3/lamp:{php_version}-dev (e.g., 8.2-dev, 8.3-dev)

• Production: fbraz3/lamp:{php_version}-phalcon (e.g., 8.2-phalcon, 8.3-phalcon)
• Development: fbraz3/lamp:{php_version}-phalcon-dev (e.g., 8.2-phalcon-dev)

• fbraz3/lamp:latest - Latest production version
• fbraz3/lamp:latest-dev - Latest development version
• fbraz3/lamp:latest-phalcon - Latest Phalcon production version
• fbraz3/lamp:latest-phalcon-dev - Latest Phalcon development version

• All images support both amd64 and arm64 architectures
• LAMP variants are also available as fbraz3/lamp:{tag}

This image supports multiple flavors to cater to different use cases:

• Vanilla: A standard LAMP stack with no additional frameworks.
• Phalcon: Includes the Phalcon PHP framework pre-installed.

Perfect for local development with easy database access and debugging tools.

The development version includes:

• phpMyAdmin accessible at http://localhost/pma/
• MariaDB with no root password (empty password)
• Direct database access for development

Optimized for production environments with enhanced security.

Run the following command to start the container:

Your application will be accessible at http://localhost/.

The production version of this image supports the execution of custom SQL scripts at startup.

To use this feature, place your SQL files in a directory (e.g., ./sql-scripts) and mount it as a volume to the container:

SQL scripts in the mounted directory will be executed in alphabetical order during container startup.

• Development Version: This version has relaxed security settings for ease of development. It is not recommended for production use.
• Production Version: This version enforces strict security measures. Ensure that you configure the root password and remove any default or test databases.

You can configure various aspects of the container using environment variables.

Commonly used variables include:

• MYSQL_ROOT_PASSWORD: Set the root password for MariaDB.
• MYSQL_DATABASE: Create a default database.
• MYSQL_USER and MYSQL_PASSWORD: Create a new user with access to the default database.

Refer to the official MariaDB Docker image documentation for a complete list of environment variables.

This image allows you to customize PHP directives using environment variables.

For detailed instructions, refer to the php-fpm-docker documentation.

Cronjobs can be configured by binding a file to /cronfile in the container. The system will automatically install and execute the jobs.

For more details, see the php-fpm-docker documentation.

To enable email sending, this image relies on the configuration provided in the php-base-docker project.

Follow the instructions in the php-base-docker documentation to set up email functionality.

Contributions are welcome! Feel free to open issues or submit pull requests to improve the project.

Please visit the CONTRIBUTING.md file for guidelines on how to contribute to this project.

• How to create a pull request
• How to report an issue

I spend a lot of time and effort maintaining this project. If you find it useful, consider supporting me with a donation:

• GitHub Sponsor
• Patreon

This project is licensed under the Apache License 2.0, so you can use it for personal and commercial projects. However, please note that the images are provided "as is" without any warranty or guarantee of any kind. Use them at your own risk.