ナレッジ
知識・原因・設定・過去のノウハウを探す場所です。やりたいこと・症状・ツール名で探せます。
「PHP」の検索結果 43件
絞り込みを解除- WordPressのプラグイン・テーマ・本体・PHP更新の安全な手順(事前確認→バックアップ→1つずつ更新→確認→戻し方) 更新は止めない(脆弱性の多くは古いプラグイン)が、まとめて一気にやらない。バックアップ→更新内容の確認→1つずつ更新→表示・フォーム・管理画面を確認。本体のメジャー更新とPHP版の変更は別の日に。壊れたら直前に更新したものを止めて戻す。
- WordPressが真っ白・500エラー・「重大なエラーが発生しました」の切り分け(PHPエラー・プラグイン・テーマ・メモリ・PHP版・.htaccess・権限・ログ) まず直前の変更とエラーログを見る。原因の多くはプラグイン・テーマの更新、PHP版変更、メモリ不足、.htaccess。1つずつ切り分け(プラグイン→テーマ→.htaccess→メモリ→PHP版→権限)、大量変更はしない。
- サーバーの基本(種類・何がどこにあるか・public_html・PHP・DB・FTP/SFTP/SSH・権限・ログ) WordPressサイトは「ファイル(public_html以下)」と「データベース(MySQL/MariaDB)」の2つでできている。ファイルはSFTP/SSHで、DBはphpMyAdminやWP-CLIで扱う。権限はフォルダ755・ファイル644が基本、777にしない。困ったらエラーログを見る。
- 認証情報(パスワード・秘密鍵・APIキー・トークン)はknowledgeに保存しない パスワード・秘密鍵の中身・APIキー・トークン・ドメイン移管の認証コード・DBパスワード(wp-config.phpの値)はknowledgeに書かない。書いてよいのは「どこにあるか」「どの種類か」まで。貼られていたら伏せ字にする。
- ログは推測の前に見る証拠(PHPログ・debug.log・Webサーバーログ・Console・APIレスポンス・Claude Codeログ)と保存時の注意 原因を推測する前に、該当する層のログを見る。PHP・WordPress・Webサーバーはサーバー側、JSはConsole、通信はNetworkとAPIの応答本文、AI作業はClaude Codeの出力・作業ファイル。ログには個人情報・トークンが含まれるので、共有・保存するときは伏せる。
- 障害時は直前の変更を疑う・変更履歴を残す(更新・CSS・DNS・サーバー設定・PHP・SSL・外部サービス) 障害の多くは直前の変更がきっかけ。WordPress・プラグインの更新(自動更新含む)、CSS、DNS、サーバー設定、PHP、SSL、外部サービスの変更を最初に確認する。そのために、いつ・何を・どこで・変更前の値・戻し方を記録しておく。
- WordPressサイトのサーバー移転の流れ(旧環境確認→バックアップ→移行→事前確認→DNS切替→SSL→メール→検査→旧サーバーは残す) サーバー移転は、旧環境(DNS全レコード・メール・PHP版・プラグイン)を控え、フルバックアップ後に新サーバーへファイルとDBを移し、hostsで事前確認してからDNSを切り替える。SSL・メール・HTTP・フォーム・画像・リンクを確認し、旧サーバーはすぐ解約しない。
- WordPressのバックアップ対象と種類の使い分け(DB・wp-content・フル/DBのみ/差分・世代管理)と「戻せるか」の確認 WordPressは「DB」と「wp-content(テーマ・プラグイン・uploads)+wp-config.php・.htaccess」を分けて考える。作業直前は変える範囲に合わせてDBのみ・ページ単位でもよいが、大きな変更前はフル。バックアップは「ある」ではなく「戻せる」ことが重要で、復元手順を事前に確認する。
- Gitの安全な使い方(commit前にstatus/diff・秘密情報をcommitしない・.gitignore・消しても履歴に残る) commit前に git status と git diff で対象と中身を確認し、git add . をむやみに使わない。.env・wp-config.php・鍵・APIキーは .gitignore で除外する。一度commitした秘密情報は、後で消しても履歴・コピー先に残るので、まずその認証情報を無効化・変更する。
- 公開後検査(公開後チェック)の項目と方法(HTTP・H1・href="#"・実クリック・スマホ390px・横スクロール・既存差分) 公開後チェック。新規・変更ページに対して、サーバー側verify、HTTP/H1/プレースホルダ/href="#"、PC・スマホ390pxの実クリック、横スクロール、既存ページ差分を確認する。全体監査は節目だけ。
- 本番・ステージング・ローカル・テストサイトの使い分け(大きな変更はいきなり本番でしない) テーマ変更・PHP更新・大型プラグイン導入・構成変更はステージングで試してから本番へ。小さな限定変更は「バックアップ+限定変更+検証」で十分なこともある。テスト環境は必ず非公開(noindex・認証)にし、本番とデータを取り違えない。
- Astraでカスタム投稿の一覧・独自検索が10件に切られる(posts_per_page が上書きされる) Astra は parse_tax_query で、すべてのアーカイブ(カスタム投稿タイプの一覧も含む)の posts_per_page を「ブログの表示件数」(既定10)に上書きする。pre_get_posts で30件・100件にしても10件になり、独自の並べ替え検索では更新順の先頭10件だけが採点される。対策は astra_blog_post_per_page_exclusions フィルターに投稿タイプを追加して除外する(テーマ・設定は変えない)。
- WordPressが遅い主な原因(テーマ・Elementor・プラグイン・画像・キャッシュ・DB・外部通信・サーバー) 原因はテーマ・ページビルダー・プラグインのCSS/JS、画像、キャッシュ未設定、肥大化したDB、外部通信、サーバー性能。速度のためにプラグインを足し続けるのは矛盾。キャッシュ系・最適化系は1つに絞り、機能を重複させない。
- WordPress・プラグイン・テーマを更新する 本体・プラグイン・テーマの更新を、バックアップ→1つずつ更新→確認で進める。まとめて一気に更新しない。壊れたときの戻し方も先に確認。
- 既存ページ保護ルール(指定箇所以外は触らない) 指定された箇所以外は変更しない。完成済みページを正式な基準にし、変更は必要最小限。作業後はバックアップとの差分で確認する。
- Elementor HTMLウィジェット2つで作る固定ページの構造とメタ(WP-CLIで再現) 1コンテナ+HTMLウィジェット3個(HTML①・HTML②・空)。_elementor_data と Astra/Elementor のメタを手本ページから複製して作る。REST APIでは保護メタを書けないのでWP-CLIを使う。
- バックアップ方針(作業前に必ず取り、削除しない) WordPressへ書き込む作業の前に毎回新しいバックアップを取る。名前は wg-backup-YYYYMMDD-<作業名>。古いバックアップは削除しない。設定を変えるときは変更前の値をファイルに残す。
- AIにHTML/CSS修正を頼むときの安全な指示(指定箇所以外を変更させない) 変更範囲・変えてよい値・禁止事項を明示し、新しいCSSは専用クラスに限定、作業後は変更前との差分とスクショで「指定箇所以外が変わっていない」ことを機械的に確認させる。
- AIにサーバー運用・障害対応を手伝わせるときの任せ方(ログ整理・差分確認・チェックリストはAI、DNS・削除・本番設定変更は人) ログ整理・設定差分・エラー文の分類・確認コマンド案・移行/バックアップのチェックリスト・原因候補の整理はAIに任せやすい。DNS変更・サーバー/DB削除・本番DB一括更新・鍵変更・メールDNS・ドメイン移管・本番サーバー設定はAIだけでやらせない。必ずバックアップ・確認・限定変更を伴う。
- ナレッジを追加・更新してサイトへ同期する 作業で分かったことを knowledge/ に足し、索引・チェックのあと guidepocket.net へ変更分だけ同期する。全件同期・全件監査はしない。
- サイトを別のサーバーへ移す サイトを新しいサーバーへ移すときの順番。旧環境の記録とバックアップ → 新サーバーで確認 → DNS切替 → SSL・メール・フォームの確認。旧サーバーはすぐ解約しない。
- WordPressを安全に変更する(バックアップ→変更→検査) ページ・設定・プラグインなどWordPressに書き込む作業の基本形。確認→バックアップ→対象限定→実行→検査の順で、1ステップずつ進める。
- WordPressセキュリティの基本(更新・不要プラグイン削除・パスワード・2FA・権限・WAF・ログ・ログイン試行・脆弱性) 被害の多くは古いプラグイン・テーマの脆弱性と弱いパスワード。更新・不要なものの削除・強いパスワード+2FA・最小限の管理者・WAF・ログ確認・バックアップを組み合わせる。セキュリティプラグインを入れれば終わりではない。
- Claude消費量を抑える検査・作業ルール 毎回全サイト監査はしない。新規・変更部分を重点検査し、全体監査は節目だけ。ファイルは検索で絞ってから必要箇所だけ読む。
- 不正アクセス・改ざんが疑われるときの対応の流れ(状況保存→隔離→認証情報変更→範囲確認→クリーンな状態へ復旧→原因対策) 見覚えのない管理者・不審なファイル・勝手なリダイレクト・スパムページは侵入の兆候。まず状況を保存し、隔離を検討、全認証情報を変更、改ざん範囲を確認し、侵入前のクリーンなバックアップか正規ファイルで復旧、原因(脆弱性・パスワード)を塞いでから再確認する。
- AIでトラブル原因を切り分ける方法(静的チェックで終わらせず実ブラウザで確かめる) 症状・再現条件・期待結果を渡し、仮説を並べさせてから実ブラウザで1つずつ確かめさせる。guidepocket.net ではHTML/CSSの静的チェックで「問題なし」とされた不具合が、実クリック調査で透明ヘッダーの重なりと特定できた。
- よく使うコマンド集(PowerShell・Claude Code起動・knowledge・WP-CLI・SSH) 作業フォルダへの移動、UTF-8表示、Claude Code起動、knowledge検索/索引/チェック、WP-CLIとSSHの読み取り専用確認、バックアップ→変更→検査の骨組み。秘密情報は書かない。
- ページが遅くなる主な原因と「調べてから直す」考え方(ページ速度の基本) 遅さの原因は画像・動画・外部埋め込み(SNS・地図)・外部フォント・JS/CSS・プラグイン・サーバー・キャッシュ設定など。「全部圧縮」ではなく、PageSpeed InsightsとDevToolsのNetworkで何が重いかを特定してから、効果の大きいものから直す。
- AIでサイト検査を自動化する考え方(サーバー側差分・HTTP・実ブラウザの3層) AIに検査スクリプトを書かせ、①サーバー側でバックアップとの差分、②HTTP・H1・href="#"、③ヘッドレスChromeでPC/390pxの実クリック・横スクロール・スクショを機械的に判定する。AIの目視判定に頼らない。
- Astra透明ヘッダー(#masthead)で上部の戻るリンクが押せない Astraの透明ヘッダー #masthead(position:absolute; z-index:99)がページ上部に重なり、見えないまま戻るリンクのクリックを奪っていた。リンクだけに position:relative; z-index:100 を追加して解決。
- 速度改善の実務手順(遅いページ特定→原因確認→1つずつ修正→再測定→PC/スマホ実動作確認) 遅いページを特定し、原因候補を画像→外部埋め込み→CSS/JS→プラグイン→キャッシュ→サーバーの順に確認。バックアップを取って1つずつ直し、再測定とPC/スマホの実動作確認をする。いきなり設定を大量に変えない。
- 障害対応の基本(いきなり直さず症状を切り分ける14の確認順) 何が・いつから・全員か一部か・端末・回線を確認してから、DNS→サーバー→WordPress→プラグイン→外部サービス→ログ→直前変更の順に原因を絞る。修正はバックアップを確認してから1つずつ。
- DNS変更・サーバー移転後に表示されない(DNS未反映か、新サーバー側の問題かを分ける) まず今そのドメインがどのIPを向いているかを確認し、「DNSがまだ旧サーバーを向いている(反映待ち・キャッシュ・hosts)」と「新サーバーを向いているのに壊れている(設定・SSL・ファイル)」を分ける。前者は待つかキャッシュを消す、後者は新サーバーを直す。
- WordPressの日本語スラッグと -2 衝突、URLの取り方 スラッグはWordPress標準のタイトル由来(sanitize_title)。英字は小文字、ドットはハイフン等に変わる。-2 が付いたら勝手に決めず確認。URLは推測せず get_permalink で取る。
- ネットショップ(EC)の作り方の選び方と必須ページ(BASE・STORES・Shopify・WooCommerce・特商法表記・API連携) 小規模ならBASE/STORES、拡張性ならShopify、WordPressに統合したいならWooCommerce(保守・セキュリティの負担大)。どれでも特商法表記・プライバシーポリシー・返品条件・最終確認画面の表示が必要。
- WordPressのフォームメール・通知メールが届かない(迷惑メールに入る・自動返信が来ない) 「送信処理が失敗している」か「送れているが受信側で弾かれる」かを分ける。SMTPプラグインのテストメールとメールログで確認し、From・Reply-Toの設定、SPF/DKIM、受信側の迷惑メールを順に見る。
- サイトから送るメールの設定(SMTP送信・SPF/DKIM/DMARC・Gmail送信者ガイドライン・メルマガのルール) WordPressのメールはSMTPプラグインで自ドメインのメールサーバーから送り、Fromは自ドメインにする。DNSにSPF・DKIM・DMARCを設定し、Gmailのヘッダーで3つともPASSを確認する。
- サーバー会社・ドメイン会社ごとの手順メモ(移行ツール・SSL・DNS・メール・ログの場所。会社固有なので要確認) 会社ごとに違う・変わりやすい手順(移行ツール、動作確認URL、SSLの発行タイミング、DNS設定画面、メールの移行、ログの場所、SSHの有効化)の確認項目と記録の置き場所。確定情報ではない。
- HP制作でGitを使う(変更履歴・差分確認・元に戻す・複数人作業)とバックアップとの違い・WordPressで管理できない部分 Gitはテーマ・子テーマ・独自プラグイン・静的HTML/CSS・スクリプト・原稿など「ファイル」の変更履歴と差分確認に強い。WordPressのDB(記事・設定)やuploadsの画像は基本Gitで管理しないので、バックアップは別に必要。本番WordPressそのものとGitのリポジトリは別物。
- AIで表示速度を改善するときの任せ方(調査・一覧化・改善案はAI、本番変更の判断は人) HTML/CSS/JSの確認、重そうな要素・画像・外部スクリプトの一覧化、改善案、変更前後の比較はAIに任せやすい。本番への大量変更、プラグイン削除、キャッシュ・CDN・サーバー設定、本番JSの一括最適化はAIだけで判断しない。必ずバックアップと検証を伴う。
- ファイル検索コピペ集(PowerShellで文字列・CSSクラス・href="#"・URL・拡張子で探す、件数を数える) 下の階層まで探すのは Get-ChildItem -Recurse -Include と Select-String の組み合わせ。-SimpleMatch で記号をそのまま検索、-Encoding UTF8 で日本語を正しく読む。件数は Measure-Object。読み取りだけなので安全。
- HTTPステータスとリダイレクトの基本(200・301・302・404・410・403・500・503) 301=恒久移転(URLを変えたとき)、302=一時移転(メンテ・キャンペーン)、404=存在しない、410=削除済み、403=アクセス禁止、500=サーバー内部エラー、503=一時的に利用不可。curl -I で確認できる。
- CORSエラーの基本(別オリジン・ブラウザの制限・Access-Control-Allow-Origin・iframeとは別問題) ブラウザのJavaScriptから別オリジン(ドメイン・プロトコル・ポートが違う)のAPIを呼ぶと、相手のサーバーがAccess-Control-Allow-Originで許可していない限りブラウザが結果を読ませない。直すのは基本的にAPI側の設定か、自分のサーバー経由で呼ぶこと。ブラウザ側のコードだけで必ず解決できるものではない。iframeの表示可否は別問題。