雛形化する前に、サイトを健康診断する
別のサイトにも再利用できる雛形にする前に、いまのサイトを一度立ち止まって点検しました。今回の健康診断を通して、Simple / Reliable / Secure にこだわる理由を改めて考えます。
🎯 目的
今回の目的は、完成したサイトをすぐに雛形として使うのではなく、 その前にサイト全体を点検する考え方を理解することです。
Webサイトは、作って公開したら終わりではありません。 その後も更新や修正を重ねながら、長く使っていくものです。
だからこそ、「いま動いているか」だけではなく、 あとから見ても分かりやすく、安全に変更できる状態になっているかを確認します。
今回やること
- 雛形にする前に、なぜ健康診断が必要なのか考える
- CSSやファイル構成など、複雑になりやすい部分を点検する
- Simple / Reliable / Secure の視点で、再利用できる状態か確認する
↓
元のサイトを健康診断する
↓
重複・複雑さ・公開範囲などを確認する
↓
必要なところだけ整理する
↓
実際の画面と動作を確認する
↓
安心して使える雛形にする
STEP 1|コピーする前に、元のサイトを見る
既存のサイトをもとに、新しいサイトやテスト環境を作ることがあります。
これは便利ですが、元のサイトに不要なファイルや複雑な構成が残っていれば、 それらまで一緒に引き継いでしまう可能性があります。
そこで今回は、IT教科書を別サイトの雛形として利用する前に、 まず元のサイトそのものを点検しました。
「コピーできる」ことと、 「そのままコピーしてよい」ことは同じではありません。
元になるサイトを一度確認してから雛形にすることで、 不要なものや分かりにくい構成まで次のサイトへ引き継ぐことを防ぎやすくなります。
STEP 2|CSSは思ったよりクセものだった
健康診断で特に気になったのがCSSでした。
ページが増えるたびに似たCSSを追加していくと、 「この指定はどこから来ているのか」 「ここを変更すると、どのページまで影響するのか」 が少しずつ分かりにくくなります。
そこで、複数ページで本当に同じ役割を持っているCSSは共通化し、 ページごとに意味のある違いがあるものは無理にまとめないようにしました。
ただし、整理する作業そのものにも注意が必要です。 CSSは小さな変更に見えても、思わぬ場所の表示に影響することがあります。
今回の作業でも、CSSを整理している途中で不要な文字が入り、 実際の画面表示が崩れることがありました。
CSSは、エラー画面が出なければ正常とは限りません。
PHPの構文チェックで問題がなくても、 CSSの見た目まで確認できるわけではありません。
そのため、
変更前に戻せる状態を作る
↓
小さく変更する
↓
構文を確認する
↓
ブラウザで実際の画面を見る
という流れを大切にします。
STEP 3|公開する必要のないものまで公開しない
健康診断では、コードの重複や見た目だけでなく、 「何がWebから見える場所に置かれているのか」も確認します。
データベースの情報や管理用のファイルなど、 サイトの内部で使うものまでWebから見える必要はありません。
また、点検を便利にするためだけに、 データベースや管理情報へアクセスする新しい入口を公開側に作れば、 確認しやすくなる一方で、新しいリスクを増やす可能性があります。
「確認しやすいから」という理由だけで仕組みを増やすのではなく、 本当に必要なのかを一度考えることも大切です。
見える必要のないものは、見える場所に置かない。
必要のない入口は、むやみに増やさない。
健康診断のために、 サイトへ新しい危険を増やしてしまっては本末転倒です。
Simple / Reliable / Secure にこだわる理由
CSSや処理を必要以上に増やさず、 あとから見ても「どこに何があるのか」が分かりやすい状態を目指します。
共通にできるものはまとめますが、 違うものまで無理に共通化しません。
Reliable
変更したら終わりではなく、 構文チェックやブラウザ表示、PC・スマートフォンでの確認を行います。
また、変更前の状態へ戻せるようにしてから、 一度に大きく変えず、小さく確認しながら進めます。
Secure
公開する必要のないものを公開領域へ置かず、 便利さのためだけに不要な入口を増やさないようにします。
→ 目指したいのは、 「作りやすいサイト」だけではなく、 作ったあとも安心して触り続けられるサイトです。
📘 前の記事とのつながり
記事が増えても一覧を見やすくする仕組みを作りました。
026|ページネーションを共通部品にする
ARTICLESとCOLUMNSで共通する処理を、一つの部品として整理しました。
027|サイトを雛形として整理する
ファイルや共通部品の役割を整理し、 次のサイトにも利用できる「型」として考えました。
今回
その雛形を安心して再利用するために、 元のサイトを点検する意味を振り返りました。
→ 「作る → 共通化する → 雛形にする」だけでなく、 再利用する前に点検するところまでが一つの流れになります。
📘 処理の流れを読む
↓
処理: ファイル構成、CSS、重複、公開範囲などを点検し、 必要な部分だけ整理する
↓
出力: Simple / Reliable / Secure を意識した、 再利用しやすい雛形
→ プログラムだけでなく作業そのものも、 「入力 → 処理 → 出力」で整理すると、 何のために点検しているのかが見えやすくなります。
📝 今回の忘備録
「いま正常に表示されている」ことと、 「今後も安全に変更しやすい」ことは同じではありません。
CSSのように影響範囲が分かりにくいものは、 増やし続けるほど保守が難しくなることがあります。 だからこそ、必要なものだけを残し、 どこを直せばよいのか分かる状態を目指します。
また、健康診断では問題を見つけるだけでなく、 点検作業そのものが新しい不具合やリスクを生まないように注意します。
動いていることと、整理されていることは違う。
整理されていることと、安全であることも違う。
次に使い回す前に、一度立ち止まって見る。 それが今回の健康診断で一番覚えておきたいことです。
この先やること
- 今回整理した雛形を、新しいサイト制作に活用する
- 新しい機能を追加するときも、Simple / Reliable / Secure を基準に考える