SiteGround Cache Buster スキル は何をしますか?
WordPress開発においてSiteGroundのキャッシュ(SG CachePress + LiteSpeed)をバイパスします。子テーマにキャッシュバスティングコードを追加し、リアルタイムな開発テストを実現します。
⛔ 重要: ステージングのみ - 本番環境では絶対に使用しないでください
Claudeは本番サイトへのデプロイを禁止されています。
| アクション | 許可? |
|---|---|
| ステージングへのデプロイ | ✅ はい |
| 本番環境へのデプロイ | ❌ 絶対にしない |
| 本番環境からの読み取り | ✅ はい(読み取り専用) |
| 本番環境への書き込み | ❌ 絶対にしない |
ユーザーが本番環境へのデプロイを依頼した場合:
- リクエストを拒否する
- 本番環境へのデプロイはユーザーが手動で行う必要があることを説明する
- 代わりにステージングへのデプロイを提案する
本番環境のパスはブロックされています。 書き込みは「staging」を含まないパスでは許可されません。
必要な情報
このスキルを使用する前に、Claudeは以下を尋ねます:
-
FTP/SFTP認証情報
- ホスト名(例:
ftp.example.com) - ユーザー名
- パスワード
- ポート(通常FTPは21、SFTPは22)
- ホスト名(例:
-
サイトURL
- ステージングURL(例:
https://staging.example.com) 本番URL(不要 - Claudeはそこにデプロイしません)
- ステージングURL(例:
-
テーマパス
- 子テーマフォルダ名(例:
theme-child)
- 子テーマフォルダ名(例:
認証情報はプロジェクトのCLAUDE.local.mdに保存してください(gitignore対象)。今後のセッションで再利用されます。
ステージングのみのワークフロー
ローカル開発 → ステージングサイト → [ユーザーが手動] → 本番
↑ ↑ ↑
Claudeが編集 Claudeがデプロイ ユーザーがデプロイ
Claudeが担当: ローカル編集 + ステージングデプロイ ユーザーが担当: 本番デプロイ(SiteGround、FTPクライアント、または手動)
機能概要
- 管理者向けサーバーサイドキャッシュを無効化 - LiteSpeed Cache + SG CachePress
- no-cacheヘッダーを追加 - CDN/プロキシキャッシュを防止
- ブラウザキャッシュを破棄 - CSS/JSのURLにタイムスタンプを追加
- バージョンバナーを表示 - テーマが読み込まれていることを視覚的に確認(管理者のみ)
コード
PHPスニペット(functions.phpに追加)
<?php
/**
* SiteGround Cache Buster for Development
* ログイン中の管理者に対してキャッシュを無効化
* テスト完了後は本番環境で削除または無効化すること
*/
// 開発モードバナー(テーマがアクティブであることを確認するバージョン表示)
add_action('wp_head', 'sg_dev_mode_banner');
function sg_dev_mode_banner() {
if (current_user_can('administrator')) {
$theme = wp_get_theme();
$version = $theme->get('Version');
$name = $theme->get('Name');
echo '<style>
.sg-dev-banner {
position: fixed;
bottom: 20px;
right: 20px;
background: #34889A;
color: white;
padding: 10px 20px;
border-radius: 8px;
font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, sans-serif;
font-size: 12px;
z-index: 999999;
box-shadow: 0 4px 12px rgba(0,0,0,0.3);
}
</style>
<div class="sg-dev-banner">
' . esc_html($name) . ' v' . esc_html($version) . ' - ' . date('M j, H:i') . '
</div>';
}
}
// 管理者のすべてのキャッシュを無効化
add_action('init', 'sg_disable_cache_for_dev');
function sg_disable_cache_for_dev() {
if (current_user_can('administrator')) {
// LiteSpeed Cacheを無効化
if (!defined('LSCACHE_NO_CACHE')) {
define('LSCACHE_NO_CACHE', true);
}
// SG Optimizer/CachePressを無効化
if (!defined('SG_CACHEPRESS_NO_CACHE')) {
define('SG_CACHEPRESS_NO_CACHE', true);
}
// no-cacheヘッダーを送信
nocache_headers();
// CDNバイパス用の追加ヘッダー
header('Cache-Control: no-store, no-cache, must-revalidate, max-age=0');
header('Pragma: no-cache');
header('Expires: Thu, 01 Jan 1970 00:00:00 GMT');
}
}
// テーマのCSS/JSにタイムスタンプを追加してブラウザキャッシュを破棄
add_filter('style_loader_src', 'sg_bust_asset_cache', 999);
add_filter('script_loader_src', 'sg_bust_asset_cache', 999);
function sg_bust_asset_cache($src) {
if (current_user_can('administrator')) {
// テーマアセットのみキャッシュを破棄
$theme_uri = get_stylesheet_directory_uri();
$parent_uri = get_template_directory_uri();
if (strpos($src, $theme_uri) !== false || strpos($src, $parent_uri) !== false) {
$src = add_query_arg('v', time(), $src);
}
}
return $src;
}
使用方法
方法1: スクリプトによる自動注入
# プロジェクトに移動
cd /path/to/wordpress-project
# インジェクタースクリプトを実行
/root/.claude/skills/siteground-cache/add-cache-buster.sh ./wp-content/themes/your-child-theme
方法2: 手動コピー
- 上記のPHPコードをコピー
- 子テーマの
functions.phpの末尾にペースト - FTPでステージングのみにアップロード
- 管理者としてステージングサイトにアクセス - バージョンバナーが表示されることを確認
方法3: Claude経由
次のように依頼するだけ:
- 「このテーマにSiteGroundキャッシュバスティングを追加して」
- 「SiteGroundの開発モードを有効にして」
- 「functions.phpにキャッシュバスターを追加して」
Claudeはステージングにのみデプロイします。
デプロイワークフロー(ステージングのみ)
ステップ1: 認証情報を取得(ユーザーに尋ねる)
デプロイ前にユーザーに尋ねてください:
ステージングにデプロイするためにFTP認証情報が必要です。以下を教えてください:
1. FTPホスト(例: ftp.yourdomain.com)
2. FTPユーザー名
3. FTPパスワード
4. ステージングサイトのパス(例: staging.yourdomain.com/public_html)
ステップ2: ステージングにデプロイ
# ステージングのみ - 本番環境では絶対にしないでください!
lftp -u "user,password" -e "
set ssl:verify-certificate no
mirror -R ./child-theme staging.example.com/public_html/wp-content/themes/child-theme
bye
" ftp://ftp.example.com
ステップ3: ステージングで確認
- 管理者としてステージングサイトにアクセス
- 開発バナーが表示されていることを確認(右下)
- CSS/JSの変更が反映されていることをテスト
- PHPエラーがないか確認
ステップ4: ユーザーが本番環境にデプロイ
Claudeはこの手順を実行しません。 ユーザーに伝えてください:
変更はステージングで準備完了です。本番環境にデプロイするには:
オプション1: SiteGround Site Tools
- Site Tools > WordPress > Staging に移動
- 「Push to Live」をクリック
オプション2: FTPクライアント(FileZilla, Cyberduckなど)
- ステージングからダウンロード
- 本番環境にアップロード
オプション3: FTPによる手動ファイルコピー
各機能の仕組み
1. LiteSpeed Cacheバイパス
define('LSCACHE_NO_CACHE', true);
LiteSpeed Cacheプラグインはこの定数をチェックし、設定時にキャッシュをスキップします。
2. SG CachePressバイパス
define('SG_CACHEPRESS_NO_CACHE', true);
SiteGroundのキャッシングプラグインはこの定数を尊重します。
3. HTTPヘッダー
nocache_headers();
header('Cache-Control: no-store, no-cache, must-revalidate, max-age=0');
ブラウザとCDNに対してレスポンスをキャッシュしないように指示します。
4. アセットキャッシュバスティング
add_query_arg('v', time(), $src);
CSS/JSのURLに?v=1704567890を追加します。タイムスタンプが毎秒変化するため、ブラウザは常に最新のファイルを取得します。
トラブルシューティング
バナーが表示されない?
- 管理者としてログインしているか確認
- 子テーマが有効化されているか確認(外観 > テーマ)
- エラーログでPHPエラーを確認
キャッシュされたコンテンツがまだ表示される?
- シークレット/プライベートブラウザウィンドウを試す
- ブラウザキャッシュを手動でクリア
- SiteGround Site Tools > Speed > Caching > Purge Cache を確認
- Cloudflareが前面にある場合は、そちらもパージする必要あり
CSSの変更が反映されない?
- ページソースを表示し、CSSのURLに
?v=タイムスタンプが付いているか確認 - ハードリフレッシュ: Ctrl+Shift+R(Windows)または Cmd+Shift+R(Mac)
このスキルのファイル
/root/.claude/skills/siteground-cache/
├── SKILL.md # このドキュメント
├── add-cache-buster.sh # 自動注入スクリプト
├── cache-buster.php # スタンドアロンPHPスニペット
└── remove-cache-buster.sh # 削除スクリプト
CLAUDE.local.mdテンプレート例
プロジェクトに保存(gitignore対象):
# SiteGround認証情報(コミットしないでください)
## FTPアクセス
- ホスト: ftp.example.com
- ユーザー: [email protected]
- パスワード: your-password
- ポート: 21
## サイトURL
- ステージング: https://staging.example.com
- 本番: https://example.com(Claudeは読み取り専用)
## テーマパス
- ステージング: staging.example.com/public_html/wp-content/themes/theme-child
- 本番: アクセス禁止(ユーザーが手動デプロイ)
関連情報
- wp-docker - ローカルWordPress開発環境
- wp-performance - 本番環境のキャッシュ最適化
- visual-qa - 変更後のスクリーンショットテスト