Cài đặt PHP Extensions (ionCube-Loader, gd,...) cho WordPress Docker Image

Khi cài đặt WordPress bằng Docker, trong nhiều trường hợp mình cần phải cài thêm PHP Extensions theo yêu cầu của một số plugins đặc biệt.

Bài viết này mình sẽ hướng dẫn cách cài đặt PHP Extensions cho PHP Docker Image, sử dụng script docker-php-extension-installer. Ưu điểm của khi dùng script cài đặt này so với cách cài đặt PHP Extensions thông thường:

Tiêu chuẩn hóa các bước cài đặt thêm PHP Extension bằng 1 lệnh duy nhất install-php-extensions
Tương thích cho mọi phiên bản PHP từ 5.5 đến 8.3.
Tương thích với nhiều hệ điều hành: Ubuntu, Alpine, Debain và nhiều PHP Image khác nhau.
Hỗ trợ 146 PHP Extensions, xem chi tiết ở đây.

1. Tạo website nháp

Để demo, mình sẽ tạo 1 website WordPress theo hướng dẫn ở đây

https://thuanbui.me/wordpress-caddy-docker/

Kiểm tra danh sách PHP Extension đã được cài mặc định

1
docker compose exec wordpress php -m

1
[PHP Modules]
2
bcmath
3
Core
4
ctype
5
curl
6
date
7
dom
8
exif
9
fileinfo
10
filter
11
gd
12
hash
13
iconv
14
imagick
15
intl
16
json
17
libxml
18
mbstring
19
mysqli
20
mysqlnd
21
openssl
22
pcre
23
PDO
24
pdo_sqlite
25
Phar
26
posix
27
random
28
readline
29
Reflection
30
session
31
SimpleXML
32
sodium
33
SPL
34
sqlite3
35
standard
36
tokenizer
37
xml
38
xmlreader
39
xmlwriter
40
Zend OPcache
41
zip
42
zlib
43

44
[Zend Modules]
45
Zend OPcache

2. Cài đặt ionCube Loader

Mình muốn cài đặt thêm PHP Extension: Ioncube Loader cho WordPress.

Tạo file Dockerfile trong cùng thư mục với file compose.yml và nhập vào nội dung sau

1
FROM wordpress:fpm-alpine
2
ADD --chmod=0755 https://github.com/mlocati/docker-php-extension-installer/releases/latest/download/install-php-extensions /usr/local/bin/
3
RUN install-php-extensions ioncube-loader

Chỉnh sửa lại file compose.yml, thay thế mục image: wordpress:fpm-alpine bằng build: .. Phần khai báo woordpress sẽ tương tự như sau

1
wordpress:
2
  build: .
3
  container_name: wordpress
4
  restart: always
5
  depends_on:
6
    - db
7
    #- redis
8
  volumes:
9
    - ./wordpress/html:/var/www/html
10
    - ./wordpress/custom.ini:/usr/local/etc/php/conf.d/custom.ini
11
  env_file: .env

Cấu hình này sẽ yêu cầu Docker tạo 1 Container mới dựa trên thông số đã được cấu hình trong file Dockerfile

Kích hoạt lại hệ thống

1
docker compose build
2
docker compose up -d

Sau đó, kiểm tra lại thông số PHP Extensions. Giờ đã thấy ionCube Loader được bổ sung trong danh sách

1
[PHP Modules]
2
bcmath
3
Core
4
ctype
5
curl
6
date
7
dom
8
exif
9
fileinfo
10
filter
11
ftp
12
gd
13
hash
14
iconv
15
imagick
16
intl
17
ionCube Loader
18
json
19
libxml
20
mbstring
21
mysqli
22
mysqlnd
23
openssl
24
pcre
25
PDO
26
pdo_sqlite
27
Phar
28
posix
29
readline
30
Reflection
31
session
32
SimpleXML
33
sodium
34
SPL
35
sqlite3
36
standard
37
tokenizer
38
xml
39
xmlreader
40
xmlwriter
41
Zend OPcache
42
zip
43
zlib
44

45
[Zend Modules]
46
Zend OPcache
47
the ionCube PHP Loader + ionCube24

Để cài thêm cùng lúc nhiều PHP Extensions, bạn sửa lại dòng thứ 3 trong Dockerfile, và thêm vào tên các extensions mong muốn

1
RUN install-php-extensions ioncube-loader xdebug

Mình đã thử cài đặt thêm PHP Extension cho nhiều phiên bản WordPress khác nhau: wordpress:php8.1-fpm-alpine, wordpress:php7.4-apache, … Tất cả đều hoạt động ngon lành, bất kể Docker OS là Debian, Ubuntu hay Alpine.