cragr/php-72-fedora repository overview

⁠PHP Docker images

This repository contains the source for building various versions of the PHP application as a reproducible Docker image using source-to-image⁠. Users can choose between RHEL and CentOS based builder images. The resulting image can be run using podman⁠.

For more information about using these images with OpenShift, please see the official OpenShift Documentation⁠.

For more information about contributing, see the Contribution Guidelines⁠. For more information about concepts used in these container images, see the Landing page⁠.

⁠Versions

PHP versions currently supported are:

• php-7.2⁠
• php-7.3⁠

RHEL versions currently supported are:

• RHEL7

CentOS versions currently supported are:

• CentOS7

⁠Installation

To build a PHP image, choose either the CentOS or RHEL based image:

• RHEL based image

  These images are available in the Red Hat Container Catalog⁠. To download it run:

  $ podman pull registry.access.redhat.com/rhscl/php-73-rhel7
  

  Copy

  To build a RHEL based PHP image, you need to run the build on a properly subscribed RHEL machine.

  $ git clone --recursive https://github.com/sclorg/s2i-php-container.git
  $ cd s2i-php-container
  $ make build TARGET=rhel7 VERSIONS=7.3
  

  Copy

• CentOS based image

  $ git clone --recursive https://github.com/sclorg/s2i-php-container.git
  $ cd s2i-php-container
  $ make build TARGET=centos7 VERSIONS=7.3
  

  Copy

Alternatively, you can pull the CentOS image from Docker Hub via:

$ podman pull centos/php-73-centos7

Note: while the installation steps are calling podman, you can replace any such calls by docker with the same arguments.

Notice: By omitting the VERSIONS parameter, the build/test action will be performed on all the supported versions of PHP.

⁠Usage

For information about usage of Dockerfile for PHP 7.3, see usage documentation⁠.

For information about usage of Dockerfile for PHP 7.2, see usage documentation⁠.

⁠Test

This repository also provides a S2I⁠ test framework, which launches tests to check functionality of a simple PHP application built on top of the s2i-php image.

Users can choose between testing a PHP test application based on a RHEL or CentOS image.

• RHEL based image

  This image is not available as a trusted build in Docker Index⁠.

  To test a RHEL7 based PHP-5.5 image, you need to run the test on a properly subscribed RHEL machine.

  $ cd s2i-php-container
  $ make test TARGET=rhel7 VERSIONS=7.3
  

  Copy

• CentOS based image

  $ cd s2i-php-container
  $ make test TARGET=centos7 VERSIONS=7.3
  

  Copy

Notice: By omitting the VERSIONS parameter, the build/test action will be performed on all the supported versions of PHP.

⁠Repository organization

• <php-version>

  • Dockerfile

    CentOS based Dockerfile.

  • Dockerfile.rhel7

    RHEL based Dockerfile. In order to perform build or test actions on this Dockerfile you need to run the action on properly subscribed RHEL machine.

  • s2i/bin/

    This folder contains scripts that are run by S2I⁠:

    • assemble

      Used to install the sources into the location where the application will be run and prepare the application for deployment (eg. installing modules using npm, etc..)

    • run

      This script is responsible for running the application, by using the application web server.

  • contrib/

    This folder contains a file with commonly used modules.

  • test/

    This folder contains the S2I⁠ test framework with a sample PHP app.

    • test-app/

      A simple PHP app used for testing purposes by the S2I⁠ test framework.

    • run

      Script that runs the S2I⁠ test framework.