Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Sign up
Appearance settings

Commit a5912d6

Browse files
committed
update README.md to enhance structure and add usage examples for Docker images
1 parent a10e5a2 commit a5912d6

File tree

5 files changed

+71
-47
lines changed

5 files changed

+71
-47
lines changed

‎.idea/.gitignore‎

Lines changed: 0 additions & 8 deletions
This file was deleted.

‎.idea/misc.xml‎

Lines changed: 0 additions & 6 deletions
This file was deleted.

‎.idea/modules.xml‎

Lines changed: 0 additions & 8 deletions
This file was deleted.

‎.idea/vcs.xml‎

Lines changed: 0 additions & 6 deletions
This file was deleted.

‎README.md‎

Lines changed: 71 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -4,19 +4,29 @@ This project provides a collection of optimized Docker images to run PHP applica
44

55
With a focus on flexibility and performance, the images are organized into categories that cater to everything from command-line tools to full development and production stacks.
66

7-
Each image is carefully maintained and regularly updated to ensure compatibility and security.
8-
9-
Explore the available options to manage, develop, and deploy your PHP applications with ease.
7+
Each image is carefully maintained and regularly updated to ensure compatibility and security.
108

119
For more technical information, please visit our [DeepWiki Page](https://deepwiki.com/fbraz3/php-system-docs) (AI generated).
1210

11+
## Table of Contents
12+
13+
1. [Who is this for?](#who-is-this-for)
14+
2. [About the author](#about-the-author)
15+
3. [Available Images](#available-images)
16+
- [Tools](#tools)
17+
- [Backend Images](#backend-images)
18+
- [Web Server Images](#web-server-images)
19+
- [Full Stack Images](#full-stack-images)
20+
4. [Build Status](#build-status)
21+
5. [Donation](#donation)
22+
1323
## Who is this for?
1424

1525
This project is designed for developers, system administrators, and DevOps engineers who need a reliable and efficient way to run PHP applications in Docker containers.
1626

1727
Whether you're building a new application, maintaining an existing one, or looking to streamline your development workflow, these images provide the tools and flexibility you need.
1828

19-
## Who I am
29+
## About the author
2030

2131
My name is Felipe Braz, a software engineer, system administrator and devops engineer with a passion for open-source software and Docker.
2232

@@ -27,18 +37,32 @@ I believe in the power of collaboration and open-source software, and I hope thi
2737
- My LinkedIn Profile: [fbraz3](https://www.linkedin.com/in/fbraz3/)
2838
- My Personal Blog: [braz.dev](https://braz.dev)
2939

30-
## Available images
40+
## Available Images
3141

32-
### Tools Images
42+
### Tools
3343

3444
A variety of tools images to help you manage your PHP applications:
3545

36-
#### Images
46+
- [PHP CLI](https://hub.docker.com/r/fbraz3/php-cli): Command line interface for PHP applications, with [phalcon framework](https://phalcon.io/) support.
47+
- [PHP Composer](https://hub.docker.com/r/fbraz3/php-composer): Command line for [Composer package manager](https://getcomposer.org/).
48+
- [WP-CLI](https://hub.docker.com/r/fbraz3/wp-cli): [Command line](https://developer.wordpress.org/cli/commands/cli/) for managing WordPress installations.
49+
- [Symfony CLI](https://hub.docker.com/r/fbraz3/symfony-cli): Command line for [Symfony framework](https://symfony.com/doc/current/setup.html).
50+
51+
#### Usage
52+
53+
```bash
54+
# Run a standalone PHP script
55+
docker run -it --rm fbraz3/php-cli:latest php myscript.php
56+
57+
# Run a PHP built-in server with Phalcon framework support
58+
docker run -it --rm -v $(pwd):/workspace -p 8000:8000 fbraz3/php-cli:latest-phalcon php -S localhost:8000
3759

38-
- [PHP CLI](https://hub.docker.com/r/fbraz3/php-cli): Command line interface for PHP applications, with phalcon framework support.
39-
- [PHP Composer](https://hub.docker.com/r/fbraz3/php-composer): Command line for Composer package manager.
40-
- [WP-CLI](https://hub.docker.com/r/fbraz3/wp-cli): Command line for managing WordPress installations.
41-
- [Symfony CLI](https://hub.docker.com/r/fbraz3/symfony-cli): Command line for Symfony framework.
60+
# Install a fresh wordpress using wp-cli
61+
docker run -it --rm -v $(pwd):/workspace fbraz3/wp-cli:latest core download --path=/workspace
62+
63+
# Install a fresh symfony using symfony-cli
64+
docker run -it --rm -v $(pwd):/workspace fbraz3/symfony-cli:latest new my_project_name
65+
```
4266

4367
#### Source Code
4468
[fbraz3/php-base-docker](https://github.com/fbraz3/php-base-docker)
@@ -47,22 +71,40 @@ A variety of tools images to help you manage your PHP applications:
4771

4872
Images focusing on PHP server backend for easy integration with most commons web servers:
4973

50-
#### Images
51-
5274
- [PHP-FPM](https://hub.docker.com/r/fbraz3/php-fpm): PHP FastCGI Process Manager, designed to work with a separate web server, such as Nginx or Apache2.
5375

76+
#### Usage
77+
78+
```bash
79+
# Run a PHP-FPM server, php-fpm socket will listening on port 1780
80+
docker run -it --rm --name=php-fpm -v $(pwd):/workspace fbraz3/php-fpm:latest php-fpm
81+
82+
# In order to run a PHP-FPM server, you need to bind it to a web server, such as Nginx or Apache2.
83+
# For example, to run the NGINX server official image and bind to the PHP-FPM server:
84+
docker run -it --rm --name=nginx -p 80:80 -v $(pwd):/workspace nginx:latest
85+
# Note: You need to manually configure the NGINX server to use the PHP-FPM server as a backend.
86+
```
87+
5488
#### Source Code
5589
[fbraz3/php-fpm-docker](https://github.com/fbraz3/php-fpm-docker)
5690

5791
### Web Server Images
5892

5993
Images providing PHP and built-in web server for easy deployment:
6094

61-
#### Images
62-
6395
- [PHP-FPM with Apache2](https://hub.docker.com/r/fbraz3/php-apache2): PHP-FPM image, including a built-in Apache2 web server.
6496
- [PHP-FPM with Nginx](https://hub.docker.com/r/fbraz3/php-nginx): PHP-FPM image, including a built-in Nginx web server.
6597

98+
#### Usage
99+
100+
```bash
101+
# Run a PHP-FPM server with Apache2, php-fpm socket will listening on port 80
102+
docker run -it --rm --name=php-apache2 -p 80:80 -v $(pwd):/workspace fbraz3/php-apache2:latest php-fpm
103+
104+
# Run a PHP-FPM server with Nginx, php-fpm socket will listening on port 80
105+
docker run -it --rm --name=php-nginx -p 80:80 -v $(pwd):/workspace fbraz3/php-nginx:latest php-fpm
106+
```
107+
66108
#### Source Code
67109
- [fbraz3/php-nginx-docker](https://github.com/fbraz3/php-nginx-docker)
68110
- [fbraz3/php-apache2-docker](https://github.com/fbraz3/php-apache2-docker)
@@ -71,11 +113,19 @@ Images providing PHP and built-in web server for easy deployment:
71113

72114
Images providing a complete stack for your development environment:
73115

74-
#### Images
75-
76116
- [LEMP](https://hub.docker.com/r/fbraz3/lnmp): Classic LNMP/LEMP image, with Linux, Nginx, MySQL and PHP, plus with PHPMyAdmin.
77117
- [LAMP](https://hub.docker.com/r/fbraz3/lamp): Classic LAMP image, with Linux, Apache2, MySQL and PHP, plus with PHPMyAdmin.
78118

119+
#### Usage
120+
121+
```bash
122+
# Run a LEMP server, php-fpm socket will listening on port 80
123+
docker run -it --rm --name=lnmp -p 80:80 -v $(pwd):/workspace fbraz3/lnmp:latest php-fpm
124+
125+
# Run a LAMP server, php-fpm socket will listening on port 80
126+
docker run -it --rm --name=lamp -p 80:80 -v $(pwd):/workspace fbraz3/lamp:latest php-fpm
127+
```
128+
79129
#### Source Code
80130

81131
- [fbraz3/lemp-docker](https://github.com/fbraz3/lemp-docker)
@@ -85,7 +135,7 @@ Images providing a complete stack for your development environment:
85135

86136
Here's a summary of the images available in this project:
87137

88-
| Image | Build schedule | Build Status |
138+
| Image | Build Schedule | Build Status |
89139
|----------------------------------------------------------------|------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
90140
| [php-cli](https://hub.docker.com/r/fbraz3/php-cli) | Every Sunday, 6:00 AM UTC | [![Base Images](https://github.com/fbraz3/php-base-docker/actions/workflows/base-images.yml/badge.svg)](https://github.com/fbraz3/php-base-docker/actions/workflows/base-images.yml) |
91141
| [phalcon](https://hub.docker.com/r/fbraz3/php-cli) | Every Sunday, 7:00 AM UTC | [![Phalcon Images](https://github.com/fbraz3/php-base-docker/actions/workflows/phalcon-images.yml/badge.svg)](https://github.com/fbraz3/php-base-docker/actions/workflows/phalcon-images.yml) |
@@ -99,6 +149,8 @@ Here's a summary of the images available in this project:
99149
| [lamp](https://hub.docker.com/r/fbraz3/lamp) | Every Wednesday, 9:00 AM UTC | [![Build Base Images](https://github.com/fbraz3/lamp-docker/actions/workflows/base-images.yml/badge.svg)](https://github.com/fbraz3/lamp-docker/actions/workflows/base-images.yml) [![Build Phalcon Images](https://github.com/fbraz3/lamp-docker/actions/workflows/phalcon-images.yml/badge.svg)](https://github.com/fbraz3/lamp-docker/actions/workflows/phalcon-images.yml) |
100150

101151
## Donation
102-
I spend a lot of time and effort maintaining all the project. If you find it useful, consider supporting me with a donation:
152+
153+
Maintaining this project requires significant time and effort. If you find it valuable, please consider supporting its development through a donation:
154+
103155
- [GitHub Sponsor](https://github.com/sponsors/fbraz3)
104156
- [Patreon](https://www.patreon.com/fbraz3)

0 commit comments

Comments
(0)

AltStyle によって変換されたページ (->オリジナル) /