コメントアウトについて、勉強したことのまとめ。
コメントとは
コメントは、プログラムのソースコード上で、「実行させない部分」のこと。
コードの注釈にあたり、規定のコメントタグで括って「コメントアウトする」。
コメント化された部分は、プログラムとは関係なく自由に記述することができる。
コードを記述している時はその内容を把握していても、後で読み返してみてよくわからなくなってしまうこともある。
そのようなときに、コメントがあるとわかりやすい。
特に、オリジナルの関数やクラスのメソッドなどに、引用や返り値などに関するコメントを記述しておき、本人だけでなく関係者全員が内容を把握できるようにする（DocComment）。
また、プログラムのソースコードを部分的に修正する場合に、消したい内容を実際に消してしまうのではなく、コメント化することで一時的に機能しないようにする。
これにより、コメント化記号を外すだけで、再度コードを実行させることができる。
コメントタグは、言語によって異なる。
<!-- --> |
/* */ |
// |
# |
|
|---|---|---|---|---|
| HTML | ○ | ✕ | ✕ | ✕ |
| CSS | ✕ | ○ | ✕ | ✕ |
| JavaScript | ✕ | ○ | ○ | ✕ |
| PHP | ✕ | ○ | ○ | ○ |
| .htaccess | ✕ | ✕ | ✕ | ○ |
HTML・XHTMLのコメントアウト
HTMLのコメント
非表示にしたい部分を <!-- と --> で括る。
<!-- （複数行）HTMLは１行でも複数行でも コメントアウトの書き方は同じ -->
ブロックをまとめてコメントアウトしたい場合
例えば、＜div＞タグなどで囲まれたブロックの中に、すでに <!--コメント--> が使われている場合、うまくコメントアウトできない。
<div class="comment">
<!--コメントしたい-->
<p>ブロック毎コメントアウトしたい</p>
</div>
そんな時に使用する方法２つ。
方法1: style タグを使う
<style>
<div class="comment">
<!--コメントしたい-->
<p>ブロック毎コメントアウトしたい</p>
</div>
</style>
方法2: script タグを使う
<script>
<div class="comment">
<!--コメントしたい-->
<p>ブロック毎コメントアウトしたい</p>
</div>
</script>
CSSのコメントアウト
CSSのコメント
非表示にしたい部分を /* と */ で括る。
/* （複数行）CSSは１行でも複数行でも コメントアウトの書き方は同じ */
PHPのコメントアウト
PHPのコメント
PHPのコメントは3種類（1行用2種類と複数行用1種類）
#単一行のコメント//単一行のコメント/* */複数行のコメント
# （シャープ記号）でコメントアウト
単一行用のコメント。 #部分から行の終わりまでがコメントアウトになる。
# この行もコメントアウト
# この行もコメントアウト
でも、 # はあまり推奨されず、次の // の方が推奨される。
// （スラッシュ記号）でコメントアウト
単一行用のコメント。
//部分から行の終わりまでがコメントアウトになる。
改行または、PHP終了タグ?>がでるまでコメント化が続く。
それ以降はコメント化が解除されて、コードが実行表示になる。
// この行もコメントアウト
// この行もコメントアウト
/* */ でコメントアウト
複数行用のコメント。 /（スラッシュ記号）と*（アスタリスク記号）で括り、コメントアウトする。 /*から始まり、*/で閉じるところまでがコメントアウトされる。
複数行で異なる */
PHPのタグ<?PHP ?>を跨いでのコメントアウトも可能。
HTMLが絡んだ場合のコメント
HTML内に埋め込まれたPHPコードでPHPのコメントを使用する場合、コメントアウトしたい範囲を <?php と ?> で括り（PHPブロック）、PHPのコメント/* */を利用するとよい。
この方法で、HTMLに埋め込まれたPHPコードもまるごとコメントアウトできる
<?php echo 'ここもコメントアウトされる。'; ?>*/
?>
PHPブロックについて
PHPはHTMLに組み込まれる事が多い。 その場合、「PHPブロック」と呼ばれるブロックで括る。
- 開始タグ：<?php
- 終了タグ：?>
<html lang="ja">
<head>
<meta charset="utf-8">
<title>PHPブロックを使用</title>
</head>
<body>
<?php echo 'ここがPHPブロック'; ?>
</body>
</html>
上記の場合、 <?php と ?> で括った "echo 'ここがPHPブロック'; が、PHPプログラム。
※ 'echo' は文字力を出力する言語構造。
感覚として覚えておくべきは、PHPブロックの外側はHTMLで、PHPブロックの内側はPHPだということ。
ちなみに、PHPブロックで終了するファイルは、PHPブロックの終了タグを書かない、というルールがある。
<html lang="ja">
<head>
<meta charset="utf-8">
<title>PHPブロックで終わる場合</title>
</head>
<body>
</body>
<?php echo "</html>";
※ 上記の場合、PHPブロックで終わっているので、
?> は書かない。コメントアウトのエラー
コメントがネスト（入れ子）になっている
PHPのコメント/* */はネストできない。 最初に現れた閉じタグですべて閉じられてしまう。
/* echo 'コメントアウトされる。'; */
echo '前の閉じタグで閉じられたので、コメントアウトできない'; */
ネストする場合は、//か#を使用する。
<?php /* echo 'Hello!'; # ネストコメント */ ?>
PHPタグの外でコメントしている
PHPのコメントアウトはPHPタグ内でしか効果がない。
echo 'PHPタグの外でコメントアウトしているので、コメントアウトされない';
?> */
<?php
/* echo 'PHPタグの中だったらコメントアウトされる'; */
?>
PHPなのにHTML etc. 用のコメントを使用している。
PHPタグ内でHTMLのコメントで括ると、当たり前だがコメントアウトされない。
<!-- echo HTMLのコメントタグではコメントアウトされない; -->
?>
<?php
/* echo 'PHPのコメントタグを使えばコメントアウトされる'; */
?>
HTMLコードも含めてPHPのコメント//を使用している
PHPのコメントでも、HTMLとPHPをまとめて//でコメントアウトすると、1行でもPHPの閉じタグ以降はコメントアウトされない。
この場合は、1行でも/* */のコメントタグを使用する。
?>
<?php /*コメントアウトされる。<?php echo 'ここも…'; ?> コメントアウトされる*/
?>
※ PHPはHTMLに埋め込んで記述することも多いため、うっかりPHPタグの外で/* */のコメントタグを使っていたり、PHPの中で<!-- -->のコメントタグを使っていたりすることがないよう、注意する。
コメントを含んだPHPソースをまとめてコメントアウト
eg. 以下のようなコメントアウトを含んだソースを一気に全部コメントアウトする場合、
// ここはコメントアウト
// ここもコメントアウト
// そしてここもコメントアウト
/* */で一気にコメントアウトが可能。
/*
// ここはコメントアウト
// ここもコメントアウト
// そしてここもコメントアウト
/*
※ 普段は//で1行コメントアウトしておいて、あとから必要な部分を/* */でまとめてコメントアウトする習慣をつけておくと良い。
DocComment
DocCommentは、関数やクラスなどを就職する、特別な形態の範囲コメント。
/** */
で括る。
以下は、DocCommentの例色々 ↓
ファイルの先頭
説明文章を完結に記述
/**
* ファイルの説明
* @copyright 会社名
* @license ライセンス
* @author 作成者 <メールアドレス>
* @link資料
*/
クラス
* クラスの説明。 *
* 1行開けて、もう少し詳しく説明することもできる。 *
* @access アクセスレベル
* @author 作成者 <メールアドレス>
* @package パッケージ名
* @copyright 会社名
* @category カテゴリー
* @since PHP7.1
* @version プログラムバージョン
* @pacage パッケージ */
関数・メソッド
@paramで関数の引数を記述できる。
@returnで関数が返す型を記述できる。
regurnが複数の型を返す場合はstring|booleanなどと記述する。
*関数/メソッド名
*処理内容
*作成日
*
*@param string $str 第一引数
* @param integer $num 第二引数
* @return array 戻り値の
*/
変数
@varタグで変数の型を明示できるが、メソッドの戻り値の型が不明な場合にのみ記述するほうがよいらしい。
@var string 名前
*/
$name;
JavaScriptのコメントアウト
JavaScriptのコメントアウト
PHPのコメントは2種類（1行用1種類と複数行用1種類）
//単一行のコメント/* */複数行のコメント
単一行のコメント
function add (a,b) {
return a + b
};
複数行のコメント
引数: a ,b 戻り値: a+b */
function add (a,b) {
return a + b
};
.htaccessのコメントアウト
.htaccessのコメント
.htaccessのコメントは、 # のみ。
単一行しか使えない。
行の途中でも、" " で括る事でコメントコメントをつけることは可能。
ただじ、Apacheのバージョンや、記述場所によってはエラーになるため、コメント行は基本独立させたほうが良い。
# 一行ずつコメントアウトする必要がある
DirectoryIndex
index.html "# 行の途中コメントは基本避ける"
References
WordPressのコメントアウトの方法をまとめています！WordPress以外にも「html」「PHP」「CSS」「JavaScript」「.htaccess」のコメントアウトの方法も解説します！
PHPでのコメントアウトの方法をご紹介します。コメントが何故か出来ないよくある事例や、コメントのいくつかの方法、HTMLソースとまとめてコメントする場合など、分かりやすくお伝えします。
コメントは、プログラミングの際に処理の役割や説明をする上で、大変重要な役割を持っています。 PHPではさまざまな方法でコメントをすることができます。 この記事では、 「//」を使用したコメントの付け方 「/* */」を使用したコメントの付け方 「#」を使用したコメントの付け方 コメントの応用的な使い方 HTML含む場合のコメント方法 コメントの注意点 などのコメントの基本的な内容から、応用的な使い方について解説します。 コメントはコーディングする上で必ずしも記載が必要なものではありませんが、重要な要素の1つであることに変わりありません。 ここではPHPのコメントについて詳しく解説していきます！ コメントとは？ ここでは、コメントについておさらいしてみましょう。 用語検索サービスである「コトバンク」では、以下のように説明しています。 「プログラムの中に書き込まれた、処理の記述以外の説明文のことをコメントという。」 コトバンク コメントは、作成者の覚書きに使用することが多い印象ですが、ファイル名やプログラムのバージョン、クラス名、関数名を記述したり、不具合を修正するときなど、さまざまな用途でよく使用されます。 一見複雑な処理でも、コメントを確認すれば処理内容が分かるように、各処理については、厳密にコメントを記載することをルールとしている企業もあります。 また、プログラムを修正するときに、元々記述している処理を消してしまうのではなく、将来元に戻す可能性のあるときに、処理をまるごとコメントして無効化するときにも使われます。 ちなみにコメントとコメントアウトは混同しやすいですが、コメントアウトはソースコードをコメントすることで、プログラムを無効化することを指します。 PHPのコメント3つのパターン ここでは、PHPでコメントするさまざまな方法について紹介します。 行頭に「//」を付ける 「//」は、行頭から行末まで１行でコメントする場合によく使用します。 一般的によく使用するタイプのコメントです。 コメント範囲を「/* */」で囲む 「/* */」は複数行コメントする場合によく使います。 間に改行を入れることも可能です。
PHP の コメント とはプログラムコード中における注釈のようなものです。3種類「 #コメント //コメント /*コメント*/ 」の記述方法があります。HTMLで表現すると「 」に相当します。PHPはコメント化された部分を無視します。
phpDocumentorとはクラスやメソッドの定義前にブロックコメントを決められた方式で記述していると、APIドキュメントを自動生成することができるツール 今回はそのphpDocumentorで記述する書式についてまとめる
今さら聞けない！HTML、CSS、PHP、JavaScriptの違いと使い分け方についてのページです。
Apache の設定ファイル .htaccess について解説します。.htaccess の書き方から、各ディレクティブの解説、環境変数の用例まで網羅しています。
