AgentSkillsCN

wp-headless-backend

使用docker-compose的MariaDB/MySQL，构建与启动WordPress无头（PHP-FPM），启用WPGraphQL，使用幂等wp-cli入口点。在被要求实现或修复此仓库中的docker/wp/Dockerfile与docker/wp/entrypoint.sh时使用。

SKILL.md
--- frontmatter
name: wp-headless-backend
description: Build and bootstrap WordPress headless (PHP-FPM) with an idempotent wp-cli entrypoint and WPGraphQL enabled, using MariaDB/MySQL from docker-compose. Use when asked to implement or fix docker/wp/Dockerfile and docker/wp/entrypoint.sh for WordPress in this repo.

WP Headless Backend

Overview

Make WordPress self-install and configure on container start with WPGraphQL enabled, while staying safe to restart. Focus on PHP-FPM image setup and an idempotent wp-cli entrypoint.

Workflow

  1. •Inspect docker/wp/Dockerfile and docker/wp/entrypoint.sh for PHP-FPM base, extensions, wp-cli, and bootstrap flow.
  2. •Ensure Dockerfile installs required PHP extensions and minimal tools, sets WORKDIR /var/www/html, and includes wp-cli.
  3. •Implement entrypoint bootstrap steps with retries for DB readiness and idempotent install guards.
  4. •Enable permalinks, install and activate WPGraphQL, and avoid destructive actions on reboot.
  5. •Finish by exec'ing PHP-FPM in foreground.

Repo Assumptions

  • •DB service is db_wp (MariaDB/MySQL), not Postgres.
  • •WordPress files are mounted from ./wordpress into /var/www/html.
  • •Edge calls PHP-FPM at wp:9000.

Required Outputs

  • •Create or update: docker/wp/Dockerfile and docker/wp/entrypoint.sh.
  • •Optionally add a minimal theme at wordpress/wp-content/themes/headless/.

Dockerfile Requirements

  • •Use PHP 8.3 FPM base.
  • •Install extensions: mysqli, pdo_mysql, gd, intl, zip, opcache.
  • •Install wp-cli (official binary).
  • •Include minimal utilities: curl, unzip, bash/sh.
  • •Set WORKDIR /var/www/html.

Entrypoint Behavior

  • •Wait for DB with retry/backoff and clear errors.
  • •If WordPress is not installed:
    • •Download core if missing.
    • •Create wp-config using env DB vars.
    • •Run wp core install using env WP_URL, WP_TITLE, WP_ADMIN_*.
    • •Set permalinks to /%postname%/.
  • •Install and activate wp-graphql plugin.
  • •If WordPress is already installed, avoid destructive actions.
  • •Always exec PHP-FPM in foreground at the end.

Acceptance Checklist

  • •Rebooting containers does not reinstall WordPress.
  • •http://localhost:8080/graphql responds.
  • •WPGraphQL plugin is active.