harugon/cloudflare

Maintainers

Package info

github.com/harugon/mediawiki-extensions-cloudflare

Type:mediawiki-extension

pkg:composer/harugon/cloudflare

Statistics

Installs: 7

Dependents: 0

Suggesters: 0

Stars: 1

Open Issues: 1

0.4.0 2026-06-28 02:11 UTC

README

English

ページの更新、画像の再アップロード時に Cloudflare のキャッシュをパージします (主に画像のキャッシュを消すことを目的としています)

MediaWiki で CloudFlare を使う – harugon のブログ

導入前に上記のページを読むことをおすすめします。

Requirements

  • PHP 8.0
  • MediaWiki 1.43

Install

Releases · harugon/mediawiki-extensions-cloudflare

上記の URL よりCloudflare-{バーション}.tar.gzのファイルをダウンロードし extensions に展開

LocalSettings.php に Cloudflare の API 情報とともに追記します。

wfLoadExtension('Cloudflare');
$wgCloudflareAPIToken = '';
$wgCloudflareZoneID = '';

推奨される認証方法は $wgCloudflareAPIToken です。API トークン - Cloudflare で "キャッシュのパージ" 権限を持つトークンを作成してください。

非推奨の $wgCloudflareEmail$wgCloudflareAPIKey も引き続き使用できますが、将来のリリースで削除されます。

// 非推奨:
$wgCloudflareEmail = '';
$wgCloudflareAPIKey = '';

Config

変数 初期値 説明
$wgCloudflareAPIToken "" API Token( API トークン - Cloudflare で作成したキャッシュパージ権限付きトークン)
$wgCloudflareEmail "" 非推奨. レガシー認証用のメールアドレス。代わりに $wgCloudflareAPIToken を使用してください。
$wgCloudflareAPIKey "" 非推奨. レガシー認証用のグローバルAPIキー。代わりに $wgCloudflareAPIToken を使用してください。
$wgCloudflareZoneID "" サイト(URL)固有の ID (サイトごとのダッシュボードで見ることができます)
$wgCloudflarePurgePage false 記事を更新時に purge する
$wgCloudflarePurgeFile true ファイル(画像)を更新時に purge する

記事ページをキャッシュする

$wgCloudflarePurgePageを有効化する場合 ページルール (Page Rule) に Bypass Cache on Cookie を設定する必要があります。 (BusinessプランとEnterpriseプランのみ有効です。)

問題

  • API Rate limits
  • Varnish を挟んでいる場合 ‥(Cloudflare->Varnish->origin 先に Cloudflare が消える可能性がある?)

Disclaimer

Cloudflare, the Cloudflare logo, and Cloudflare Workers are trademarks and/or registered trademarks of Cloudflare, Inc. in the United States and other jurisdictions.