ntninja/wordpress-postgresql

WordPress with PostgreSQL 镜像文档

镜像概述

本镜像基于官方WordPress镜像构建，通过最小化修改实现对PostgreSQL数据库系统的支持，替代默认的MySQL依赖。容器每晚由docker-image-rebuilder自动构建，当上游Alpine包或WordPress文件更新时会同步获取更新。(Dockerfile)

注意：这绝非官方支持的配置，部分插件可能存在兼容性问题！

核心功能与特性

• 安装PHP pgsql PostgreSQL客户端扩展
• 集成https://github.com/kevinoid/postgresql-for-wordpress/%E6%8F%92%E4%BB%B6%E6%96%87%E4%BB%B6
• 添加启动包装脚本，确保db.php钩子脚本放置在正确目录

使用场景

适用于需要使用PostgreSQL数据库后端运行WordPress的场景，尤其适合已有PostgreSQL基础设施或偏好PostgreSQL的用户。

使用方法

基础参考

请参考官方WordPress镜像的“https://hub.docker.com/_/wordpress#how-to-use-this-image%E2%80%9D%E9%83%A8%E5%88%86%EF%BC%8C%E4%BD%BF%E7%94%A8%E6%97%B6%E9%9C%80%E5%B0%86%E6%89%80%E6%9C%89%E2%80%9CMySQL%E2%80%9D%E6%9B%BF%E6%8D%A2%E4%B8%BA%E2%80%9CPostgreSQL%E2%80%9D%E3%80%82

数据持久化

WordPress会将数据文件复制到容器当前工作目录（默认/var/www/html）。使用此容器时，必须为工作目录下的wp-config和wp-content子目录添加数据卷，否则升级时数据将丢失！

Docker Run示例

bash
docker run -d \
  -e WORDPRESS_DB_HOST=postgres-host:5432 \
  -e WORDPRESS_DB_USER=wpuser \
  -e WORDPRESS_DB_PASSWORD=wppassword \
  -e WORDPRESS_DB_NAME=wpdb \
  -v wp-config:/var/www/html/wp-config \
  -v wp-content:/var/www/html/wp-content \
  --name wordpress-postgres \
  ntninja/wordpress-postgresql

Docker Compose示例

yaml
version: '3'
services:
  wordpress:
    image: ntninja/wordpress-postgresql
    ports:
      - "80:80"
    environment:
      WORDPRESS_DB_HOST: postgres:5432
      WORDPRESS_DB_USER: wpuser
      WORDPRESS_DB_PASSWORD: wppassword
      WORDPRESS_DB_NAME: wpdb
    volumes:
      - wp-config:/var/www/html/wp-config
      - wp-content:/var/www/html/wp-content
    depends_on:
      - postgres
  postgres:
    image: postgres:14
    environment:
      POSTGRES_USER: wpuser
      POSTGRES_PASSWORD: wppassword
      POSTGRES_DB: wpdb
    volumes:
      - postgres-data:/var/lib/postgresql/data

volumes:
  wp-config:
  wp-content:
  postgres-data:

故障排除

原理说明

“PostgreSQL for WordPress”通过注册为WordPress默认数据库驱动，在将查询发送到PostgreSQL前重写MySQL原生查询。由于MySQL与PostgreSQL的SQL方言差异较大，可能会导致兼容性问题。

解决数据库相关插件问题

若使用某些插件时遇到数据库相关问题，可按以下步骤尝试修复（需具备基本Unix Shell、PHP知识及SQL经验）：

1. 进入wp-content目录：

   bash
   cd /var/www/html/wp-content
   

2. 克隆最新版“PostgreSQL for WordPress”：

   bash
   git clone https://github.com/kevinoid/postgresql-for-wordpress.git
   

3. 创建指向pg4wp子目录的符号链接：

   bash
   ln -s postgresql-for-wordpress/pg4wp
   

4. 安装将立即使用刚下载的“PostgreSQL for WordPress”

5. 打开pg4wp/driver_pgsql.php，定位失败的查询及其依赖的MySQL特有语法

6. 修复问题并提交修改

7. 在https://github.com/kevinoid/postgresql-for-wordpress/%E5%88%9B%E5%BB%BAPull Request