Artı Teknoloji - Teknolojiye Artı
WordPress DevOps & CI/CD Automation: Bedrock, Composer & Zero-Downtime - Baskı Önizleme

+- Artı Teknoloji - Teknolojiye Artı (https://www.artiteknoloji.com)
+-- Forum: Web Tabanlı Uygulamalar (https://www.artiteknoloji.com/forumdisplay.php?fid=44)
+--- Forum: WordPress (https://www.artiteknoloji.com/forumdisplay.php?fid=47)
+--- Konu Başlığı: WordPress DevOps & CI/CD Automation: Bedrock, Composer & Zero-Downtime (/showthread.php?tid=581)



WordPress DevOps & CI/CD Automation: Bedrock, Composer & Zero-Downtime - Wertomy® - 19-11-2026

WordPress DevOps & CI/CD Automation: Bedrock, Composer & Zero-Downtime

Manually clicking "Update Now" inside a live production WordPress dashboard or dragging modified PHP files over SFTP is an architectural gamble that eventually breaks revenue-generating websites. A single mid-transfer partial upload triggers fatal PHP parse errors for live visitors, untracked plugin updates introduce breaking changes without staging verification, and hardcoded database credentials inside wp-config.php leak across developer laptops. Adopting Roots Bedrock’s twelve-factor directory layout, managing WordPress core and plugins declaratively through Composer and WPackagist, automating security and syntax gates inside GitHub Actions, and executing atomic symlink deployments with WP-CLI cache flushes turns WordPress into a reproducible, institutional-grade software engineering pipeline.



Twelve-Factor Architecture: Classic WordPress vs. Roots Bedrock

Standard WordPress installations mix core system files, third-party plugins, uploaded media, and configuration secrets inside one flat public directory. **Roots Bedrock** restructures WordPress around twelve-factor application principles—isolating the public document root strictly to /web, externalizing environment secrets into .env files, and declaring every core and plugin version inside composer.json:

[table]
[tr]
[td]Engineering Dimension[/td]
[td]Traditional WordPress Layout[/td]
[td]Bedrock + Composer Architecture[/td]
[/tr]
[tr]
[td]Web Server Document Root[/td]
[td]Project root (/var/www/site) exposing wp-config.php & vendor files[/td]
[td]Isolated /web subdirectory; .env and vendor/ live outside webroot[/td]
[/tr]
[tr]
[td]Core & Plugin Versioning[/td]
[td]Unversioned binary ZIP updates stored in Git or edited live[/td]
[td]Declarative composer.json + deterministic composer.lock[/td]
[/tr]
[tr]
[td]Environment Configuration[/td]
[td]Hardcoded constants inside wp-config.php per server[/td]
[td]Twelve-factor .env injection via vlucas/phpdotenv[/td]
[/tr]
[tr]
[td]Plugin Directory & Core Path[/td]
[td]Core mixed with wp-content in root[/td]
[td]Core isolated in /web/wp; plugins/themes in /web/app[/td]
[/tr]
[tr]
[td]Production Deployment[/td]
[td]In-place SFTP overwrite causing transient mid-deploy errors[/td]
[td]Immutable CI build artifact + atomic symlink switch[/td]
[/tr]
[/table]

Declarative Dependency Management with Composer & WPackagist

By registering https://wpackagist.org inside composer.json, every public WordPress.org plugin and theme becomes a first-class Composer package pinned to exact semantic versions. Your Git repository tracks only your custom theme, custom mu-plugins, composer.json, and composer.lock—shrinking repository size by 95% while guaranteeing identical dependency trees across local Docker containers, staging environments, and production clusters:

Kod:
{
  "name": "acme/enterprise-wordpress",
  "type": "project",
  "license": "proprietary",
  "repositories": [
    {
      "type": "composer",
      "url": "https://wpackagist.org",
      "only": ["wpackagist-plugin/*", "wpackagist-theme/*"]
    },
    {
      "type": "composer",
      "url": "https://connect.advancedcustomfields.com"
    }
  ],
  "require": {
    "php": ">=8.3",
    "composer/installers": "^2.2",
    "vlucas/phpdotenv": "^5.6",
    "oscarotero/env": "^2.1",
    "roots/bedrock-autoloader": "^1.0",
    "roots/wordpress": "6.7.1",
    "roots/wp-config": "1.0.0",
    "wpackagist-plugin/redis-cache": "^2.5.4",
    "wpackagist-plugin/wp-graphql": "^1.29.0",
    "wpackagist-plugin/safe-svg": "^2.2.6",
    "wpengine/advanced-custom-fields-pro": "^6.3.10"
  },
  "extra": {
    "wordpress-install-dir": "web/wp",
    "installer-paths": {
      "web/app/mu-plugins/{$name}/": ["type:wordpress-muplugin"],
      "web/app/plugins/{$name}/": ["type:wordpress-plugin"],
      "web/app/themes/{$name}/": ["type:wordpress-theme"]
    }
  },
  "config": {
    "optimize-autoloader": true,
    "preferred-install": "dist",
    "allow-plugins": {
      "composer/installers": true,
      "roots/wordpress-core-installer": true
    }
  }
}
Notice how roots/bedrock-autoloader solves a long-standing WordPress limitation: standard WordPress ignores subdirectories inside mu-plugins/, whereas Bedrock’s autoloader automatically boots Composer-installed must-use plugins stored inside nested directories without requiring manual loader shims.

Alıntı:Keep DISALLOW_FILE_MODS enabled in production environments: once your team manages WordPress core and plugins via composer.lock, dashboard updates should be permanently disabled so production servers never drift from Git.

Automated CI/CD Pipeline and Atomic Symlink Release Swapping

When an engineer merges a pull request into main, GitHub Actions validates PHP syntax, runs PHPCS WordPress Coding Standards checks, compiles Gutenberg block assets via npm run build, installs production-only Composer dependencies (--no-dev --optimize-autoloader), and deploys a self-contained release archive onto production web nodes without ever exposing Composer or Node.js compilers on the live server:

Kod:
# .github/workflows/deploy-production.yml
name: Production Zero-Downtime Deploy

on:
  push:
    branches: [main]

jobs:
  build-and-deploy:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4

      - name: Setup PHP 8.3 & Install Production Dependencies
        uses: shivammathur/setup-php@v2
        with:
          php-version: '8.3'
          tools: composer:v2

      - name: Validate Composer Lock & Install Vendors
        run: |
          composer validate --strict
          composer install --no-dev --prefer-dist --no-interaction --optimize-autoloader

      - name: Build Custom Theme & Gutenberg Blocks
        uses: actions/setup-node@v4
        with:
          node-version: '20'
          cache: 'npm'
          cache-dependency-path: web/app/themes/acme-theme/package-lock.json
        run: |
          npm ci --prefix web/app/themes/acme-theme
          npm run build --prefix web/app/themes/acme-theme

      - name: Atomic Symlink Release & WP-CLI Cache Flush
        uses: appleboy/ssh-action@v1.0.3
        with:
          host: ${{ secrets.PROD_HOST }}
          username: deploy
          key: ${{ secrets.PROD_SSH_KEY }}
          script: |
            RELEASE="/var/www/acme/releases/${{ github.sha }}"
            mkdir -p "$RELEASE"
            # Sync built artifact into timestamped release directory
            rsync -az --delete ./ "$RELEASE/"
            # Link persistent shared secrets and user uploads
            ln -sfn /var/www/acme/shared/.env "$RELEASE/.env"
            rm -rf "$RELEASE/web/app/uploads"
            ln -sfn /var/www/acme/shared/uploads "$RELEASE/web/app/uploads"
            # Atomic POSIX symlink flip + WP-CLI database/cache reconciliation
            ln -sfn "$RELEASE" /var/www/acme/current
            cd /var/www/acme/current
            wp core update-db --quiet
            wp cache flush --quiet
            wp rewrite flush --hard --quiet
            sudo systemctl reload php8.3-fpm
            # Retain last 5 releases for instant 1-second rollback
            ls -dt /var/www/acme/releases/* | tail -n +6 | xargs -r rm -rf
Post-Deploy WP-CLI Automation and Instant Rollback Mechanics

Executing ln -sfn "$RELEASE" /var/www/acme/current updates the filesystem pointer atomically in under a millisecond—guaranteeing that concurrent visitors never hit half-uploaded PHP files. However, two subtle deployment hazards still catch unprepared teams unless handled explicitly:

  1. PHP OPcache Realpath & Symlink Invalidation: When PHP-FPM caches compiled bytecode with opcache.validate_timestamps=0 for peak throughput, flipping a symlink alone does not force existing PHP workers to re-read files unless you execute systemctl reload php8.3-fpm (or call opcache_reset() inside a CLI/FastCGI hook) immediately after updating /current.
  2. Safe Database Schema Migrations & Instant Rollbacks: Running wp core update-db and wp wc update automatically during deployment upgrades database tables cleanly without manual admin clicks. Because the previous five release directories remain intact inside /var/www/acme/releases/, rolling back a faulty release requires nothing more than repointing the current symlink to the previous commit SHA and reloading PHP-FPM—restoring service in under three seconds.

Database Synchronization Between Production and Staging via WP-CLI

Complete DevOps maturity also streamlines pulling fresh production content down to staging without leaking customer PII or firing real emails. Scripting wp db export - | zstd alongside wp search-replace 'https://www.example.com' 'https://staging.example.com' --all-tables --precise (which safely handles serialized PHP arrays inside wp_options and wp_postmeta), followed by scrubbing customer emails and disabling outgoing SMTP plugins, gives developers realistic staging data in seconds while protecting production stability completely.