INTEREST JOURNAL DRUPAL & WEB

Drupal 12 beta2でDrushを代用できるか:コアCLIとPHPの比較検証

約3,900文字 読了目安:約8分

English ↗
この記事の目次

Drushが入らなかった環境で、何ができるか

Drupal 12ベータの検証記録 では、当時試したDrushの導入が依存関係の競合で失敗しました。そこで今回は、同じ検証環境で、Drupalコアに含まれるCLIやPHPからのAPI利用で何を代用できるかを調べました。

結果として、状態確認とキャッシュ再構築はコアCLIで実行できました。モジュール導入はdry-runまで確認できました。 一方で、DB更新や設定同期など、今回のコマンド一覧では対応するものが見つからない処理もあります。

ここでは、機能が用意されていることと、実際に処理を行ったことを分けて記録します。Drushそのものは、この環境では実行していません。

検証した構成

2026年11月7日に、MacBook上の既存DDEV環境で確認しました。

項目 確認した構成
Drupal 12.0.0-beta2
コンテナー内のPHP CLI 8.5.12
Symfony Console/Runtime composer.lockでは各v8.1.9
Drush 未導入
実行場所 Drupalプロジェクトのルート。webの一つ上

ホスト側のPHPは8.4.27でした。今回の処理はddev execを通し、Drupal 12の検証用コンテナー内のPHPで実行しています。ローカルのベータ版検証であり、本番環境への導入・更新の検証ではありません。

PHP・Symfony Console・DrupalコアCLIの関係

PHPはプログラムを実行するための処理系です。phpを実行すればDrushのコマンドがそのまま使えるわけではありません。Drupalを操作するには、Drupalを起動して必要なAPIやサービスを呼び出す処理が必要です。

Symfony Consoleは、CLIのコマンド・引数・出力などを扱う部品です。DrupalのコアCLIはこの部品を使って作られています。公式CLI APIの説明 ↗ でも、Drupalが採用するSymfonyの版に基づく仕組みとして案内されています。Symfonyのbin/consoleやcache:clearを、そのままDrupal用のコマンドとして読み替えるものではありません。

今回使えた入口はvendor/bin/drです。Composerが用意した入口から、Drupalコアのcore/scripts/drへ処理が渡されます。従来のcore/scripts/drupalは、手元のbeta2のコードでは非推奨の転送用スクリプトになっていました。コアCLIの変更記録 ↗ と、Symfony Console公式資料 も参照できます。

Drushと代替方法の比較

下表のDrush列は、一般的なコマンドの対応を示す比較です。このbeta2環境でDrushを導入して、出力やすべてのオプションを比較した結果ではありません。コアCLIは、インストール済みモジュール等によって利用できるコマンドが変わります。

目的 Drushでの例 今回のコアCLI・別の方法 今回の確認範囲
状態表示 drush status vendor/bin/dr system:status 実行成功。Drupal・PHP・テーマ等を表示。Drushと同じ項目・出力形式とは限らない
キャッシュ再構築 drush cache:rebuild vendor/bin/dr cache:rebuild 実行成功。テスト項目の消失を確認
cron drush cron vendor/bin/dr system:cron 一覧・ヘルプ確認。タスク本体は未実行
一時ログインURL drush user:login vendor/bin/dr user:login 一覧・ヘルプ確認。URLの生成・ログインは未実行
モジュール導入 drush pm:enable vendor/bin/dr ex:install。pm:install等の別名もあり basic_authを指定したdry-run成功。実導入は未実行
テーマ導入 drush theme:install vendor/bin/dr ex:install ヘルプ・ソースで対象を確認。実導入や既定テーマ変更は未実行
DB更新 drush updatedb 今回の一覧に同名コマンドなし。公式手順ではWebのupdate.phpも案内 CLIの未登録を確認。DB更新・Web操作は未実行
設定同期 drush config:export/config:import 今回の一覧に同名コマンドなし 未登録を確認。設定同期は未実行
設定・状態の変更 drush config:set/state:set 今回の一覧に同名コマンドなし。PHPからのAPI利用は別途実装が必要 未登録を確認。書き換えは未実行
PHP処理 drush php:eval Drupalを起動するPHPスクリプトを作成 APIで版・件数・設定の読み取りを実行。任意処理の互換性確認ではない
DBバックアップ drush sql:dump DDEVのexport-dbなど 公式資料上の別案。今回の比較では未実行

また、pm:uninstallやtheme:enableも今回の一覧にはありませんでした。テーマの導入はex:installの対象ですが、既定テーマの変更まで同じ処理になるわけではありません。名前だけで判断せず、対象の版で一覧とヘルプを確認します。

実際に動かしたコマンド

以下はプロジェクトルートから実行した例です。URLは今回のローカル検証環境のものなので、別の環境ではそのまま使わず、対象サイトに合わせます。

ddev exec php vendor/bin/dr --version
ddev exec php vendor/bin/dr --url=https://interest-dr12.ddev.site list --format=json
ddev exec php vendor/bin/dr --url=https://interest-dr12.ddev.site system:status
ddev exec php vendor/bin/dr --url=https://interest-dr12.ddev.site cache:rebuild

状態表示ではDrupal 12.0.0-beta2、PHP 8.5.12、既定テーマinterestなどを確認できました。キャッシュ再構築は終了コード0で完了しています。

表示だけで判断しないため、PHPで検証専用のキャッシュ項目を一つ保存してからコアCLIを実行し、その項目が消えたことも確認しました。前後のノード数60件・ユーザー数2件、既定テーマ、メンテナンス状態は変わっていませんでした。これは確認した項目の一致であり、DB全体に変更がないことを証明するものではありません。

モジュール導入は、変更を行わない次のコマンドで確認しました。

ddev exec php vendor/bin/dr --url=https://interest-dr12.ddev.site ex:install basic_auth --dry-run

basic_authが導入候補として表示され、変更を行わない旨のメッセージとともに終了コード0で完了しました。最初に試したbanは、この環境ではモジュール・テーマとして見つからず終了コード1でした。以前のガイドに出てくる名前を、そのまま別の版へ持ち込めるとは限りません。

PHPから直接操作する場合に増える責任

今回は、PHPからDrupalを起動し、バージョン、ノード・ユーザー件数、テーマ設定、メンテナンス状態を読み取る処理も実行しました。DrushがなくてもAPIへアクセスできることを確認できています。

ただし、php -rで関数を一つ呼べばDrushと同じ、という比較にはなりません。オートローダー、対象サイト、Drupalの起動、例外処理などを自分で整える必要があります。DB更新や設定同期では、実行順序やバッチ処理、失敗時の扱いなども検討対象です。今回の読み取り確認から、それらの処理まで代用できたとは判断していません。

繰り返し使う操作を独自CLIとして整える場合は、公式のコマンド移植ガイド ↗ にある、サービスとCLIの入口を分ける考え方も参考になります。今回、独自コマンドの追加や追加パッケージの導入は行っていません。

今回の結論と次の検証

Drushの導入で止まった場合でも、まず対象環境のvendor/bin/dr listを確認すると、コアに含まれる操作を見つけられます。このbeta2環境では、状態確認とキャッシュ再構築を実行でき、モジュール導入のdry-runまで確認できました。

DB更新・設定同期・モジュールの実導入などは今回の実行確認に含まれません。特にDB更新は、公式のコア更新手順 ↗ で案内されるupdate.phpを含め、バックアップや更新対象を準備した別の検証として扱います。

今回の結果は2026年11月7日のこの環境に限った記録です。Drushの将来版やすべてのDrupal 12環境の対応可否を示すものではありません。

Drushのコマンド一覧 ・DB更新コマンド ・状態表示コマンド と、DDEVのコマンド資料 も比較の参照先にしています。

Drupal 11・12の検証とサンプルへ · Drupal 12ベータの前回検証

追記:DB更新と復元の追加検証

本記事の時点では未実行だったDB更新について、別の複製環境でWebのupdate.php、失敗時のDB復元、検証用フックに限定したPHP救済案を確認しました。DB更新の追加検証 を参照してください。上の比較表は初回検証時の記録として残しています。

Drupal 11・12の検証とサンプルへ ↗