設定は開発環境で変更し、差分をレビューしてから本番へ同期します。コンテンツ、アップロードファイル、秘密情報は設定同期と別に扱います。
# 開発環境
drush config:export -y
git add config/sync
git commit -m 'Update Drupal configuration'
# 本番デプロイ後
drush config:import -y
drush cache:rebuild同期前にはデータベースバックアップを取り、表示された差分に意図しない削除がないことを確認してください。
参考: 公式ドキュメント
Drupal本体・モジュール・DrushはComposerで管理します。Webサーバーの公開ディレクトリはプロジェクトのwebに限定します。
sudo apt update
sudo apt install php php-cli php-mysql unzip
composer create-project drupal/recommended-project site
cd site
composer require drush/drushインストール後はファイル権限、データベース接続、公開ファイルのバックアップ、更新手順を運用文書に残します。
参考: 公式ドキュメント
Drupal 5向けTinyMCE手順は使いません。Drupal 11では有効なテキスト形式、許可HTML、メディア、編集権限をまとめて設計します。
# 本番で直接変更せず、検証環境で確認する
drush config:export -y
drush config:import -y
drush cache:rebuild外部エディターを採用する場合も、保守状況、セキュリティ方針、メディア統合、アップデート手順を先に評価します。
参考: 公式ドキュメント
Drupal 11はComposerで依存関係を固定し、Webルート、公開ファイル、設定同期ディレクトリを分けます。OSやPHPのサポート期間も運用計画に含めます。
composer create-project drupal/recommended-project my_site
cd my_site
composer require drush/drush
php -d memory_limit=256M ../vendor/bin/drush status本番へ直接手作業で変更せず、検証環境でComposer更新と設定同期を確認してからデプロイします。
参考: 公式ドキュメント
InnoDBの改善は定期的なOPTIMIZE TABLEではなく、バックアップ、遅いクエリ、実行計画、索引、ロック待ちを根拠に行います。
EXPLAIN ANALYZE
SELECT id, title
FROM articles
WHERE published = 1
ORDER BY created DESC
LIMIT 20;変更前には復元可能なバックアップを取り、索引追加は書き込み負荷とロック影響を検証してから実施します。
参考: 公式ドキュメント
フォームはFormBaseまたはConfigFormBaseを継承し、入力検証と保存処理を分けます。サービスが必要ならコンストラクター注入を使います。
public function buildForm(array $form, FormStateInterface $form_state): array {
$form['label'] = [
'#type' => 'textfield',
'#title' => $this->t('Label'),
'#required' => TRUE,
];
return $form;
}権限、CSRF保護、入力値の検証を省略せず、保存前後の振る舞いをテストします。
参考: 公式ドキュメント
ページタイトルはルート、コントローラー、ブロック、テーマの責務を分けて設定します。HTMLを直接連結してtitleタグを変更する方法は使いません。
example_tools.report:
path: '/example-tools/report'
defaults:
_controller: '\Drupal\example_tools\Controller\ReportController::page'
_title: '運用レポート'
requirements:
_permission: 'access content'動的タイトルは翻訳可能な文字列として返し、画面の見出しとブラウザーのタイトルが矛盾しないよう確認します。
参考: 公式ドキュメント
文字コード移行は必ずバックアップと検証環境で行います。現在はutf8mb3や曖昧なutf8指定ではなくutf8mb4を明示します。
mysqldump --single-transaction --routines appdb > appdb-before-charset.sql
mysql appdb -e "ALTER TABLE articles CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_0900_ai_ci;"
mysql appdb -e "SHOW FULL COLUMNS FROM articles;"実データがlatin1として誤認識されているケースは別手順です。少量の実データで往復検証してから本番へ進めます。
参考: 公式ドキュメント
設定はConfiguration APIで管理し、開発環境で検証してからエクスポート済みYAMLをデプロイします。旧バージョンの変数テーブル直接操作は使いません。
$config = $this->config('example_tools.settings');
$enabled = $config->get('enabled');
// config/install/example_tools.settings.yml
enabled: true秘密情報は設定エクスポートへ含めず、settings.phpまたは専用のシークレット管理で扱います。
参考: 公式ドキュメント
拡張ポイントがイベントとして提供されている場合は、イベントサブスクライバーで処理を登録します。既存hookとイベントは用途ごとに使い分けます。
services:
example_tools.response_subscriber:
class: Drupal\example_tools\EventSubscriber\ResponseSubscriber
tags:
- { name: event_subscriber }処理は副作用を小さく保ち、キャッシュやレスポンスを不用意に変更しないよう自動テストを用意します。
参考: 公式ドキュメント