basantmandal/hk2-php8.1-fpm repository overview

⁠HK2 Magento PHP 8.1 FPM

PHP 8.1 FPM Docker environment specifically optimized for Magento 2.4.4 till Magento 2.4.6

⁠📄 Overview

The HK2 Magento PHP 8.1 FPM project provides a highly optimized, fully configured PHP 8.1 FPM Docker image specifically designed to run Magento 2.4.4 till Magento 2.4.6 environments. It includes all necessary PHP extensions, Composer 1.x, IonCube loaders (with automatic architecture detection for Mac compatibility), and built-in MSMTP support for email routing.

⁠👥 Who is this for?

• Magento 2 Backend and Frontend Developers
• DevOps Engineers managing Magento environments
• E-commerce technical agencies running legacy Magento 2 versions on modern hardware (including Apple Silicon)

⁠✨ Key Features

⁠📋 System Requirements

⁠🚀 Installation & Usage

⁠1. Using Pre-built Image from Docker Hub (Recommended)

The simplest way to use this environment is to pull the pre-built, multi-architecture image directly from Docker Hub:

docker pull basantmandal/hk2-php8.1-fpm:latest

(You can also pin to a specific version like :3.0)

⁠2. Using Docker Compose

Add the following service to your docker-compose.yml:

services:
  php:
    image: basantmandal/hk2-php8.1-fpm:3.0
    build:
      context: .
      args:
        - INSTALL_XDEBUG=false  # Set to true to install Xdebug
    volumes:
      - ./src:/var/www/html
    ports:
      - "9000:9000"

⁠3. Local Development & Testing

If you need to build the image locally or modify configurations:

Clone the repository:

git clone https://github.com/basantmandal/docker-magento2-php81.git
cd docker-magento2-php81

Build the image locally (no cache):

./local_build.sh

Run Automated Validation Tests: Ensure PHP version, required extensions, Composer, and IonCube loaded correctly within the container:

./scripts/03.test.sh

Push to Docker Hub (Maintainers):

./scripts/local_upload_image.sh

⁠⚙️ Configuration

⁠🔒 Content Security Policy (CSP)

This image relies on your web server (Nginx/Apache) or Magento application to configure and enforce Content Security Policies. Ensure your web server passes appropriate CSP headers.

⁠🔐 Privacy & GDPR

This container image does not independently collect, store, or transmit any personally identifiable information (PII). All log outputs are written to standard output (stdout/stderr) and managed locally by your Docker daemon.

⁠📚 Documentation

⁠⚠️ Known Limitations

• Running PHP 8.1 means this environment is meant for legacy operations and should not be used for new Magento 2.4.4+ projects, which require PHP 8.1+.
• Xdebug is turned off by default (INSTALL_XDEBUG=false) to prevent performance penalties in production-like environments.

⁠🤝 Contributing

We actively welcome contributions! Please read our Contributing Guidelines⁠ to understand how to submit bug reports, feature requests, and pull requests.

⁠📄 License

This project is licensed under the OSL 3.0 License. See the LICENSE⁠ file for details.

⁠⚖️ Disclaimer

The author provides this Docker image "as is" without any warranties. Users are responsible for ensuring that running this environment complies with their internal security and software requirements.