PHP コメントの書き方

Notice: A non well formed numeric value encountered in /home/users/2/solat/web/7hack.net/www/htdocs/wordpress/wp-content/plugins/urvanov-syntax-highlighter/class-urvanov-syntax-highlighter-formatter.php on line 118

Notice: A non well formed numeric value encountered in /home/users/2/solat/web/7hack.net/www/htdocs/wordpress/wp-content/plugins/urvanov-syntax-highlighter/class-urvanov-syntax-highlighter-formatter.php on line 119

Notice: A non well formed numeric value encountered in /home/users/2/solat/web/7hack.net/www/htdocs/wordpress/wp-content/plugins/urvanov-syntax-highlighter/class-urvanov-syntax-highlighter-formatter.php on line 118

Notice: A non well formed numeric value encountered in /home/users/2/solat/web/7hack.net/www/htdocs/wordpress/wp-content/plugins/urvanov-syntax-highlighter/class-urvanov-syntax-highlighter-formatter.php on line 119

Notice: A non well formed numeric value encountered in /home/users/2/solat/web/7hack.net/www/htdocs/wordpress/wp-content/plugins/urvanov-syntax-highlighter/class-urvanov-syntax-highlighter-formatter.php on line 118

Notice: A non well formed numeric value encountered in /home/users/2/solat/web/7hack.net/www/htdocs/wordpress/wp-content/plugins/urvanov-syntax-highlighter/class-urvanov-syntax-highlighter-formatter.php on line 119

Notice: A non well formed numeric value encountered in /home/users/2/solat/web/7hack.net/www/htdocs/wordpress/wp-content/plugins/urvanov-syntax-highlighter/class-urvanov-syntax-highlighter-formatter.php on line 118

Notice: A non well formed numeric value encountered in /home/users/2/solat/web/7hack.net/www/htdocs/wordpress/wp-content/plugins/urvanov-syntax-highlighter/class-urvanov-syntax-highlighter-formatter.php on line 119

概要

PHP等のプログラミング言語では、どうしてその処理を実行するのか、

ソースだけだと分かりづらい状態になってしまいます。

どうしてその処理を書いたのか分かりやすく日本語などで説明を加えることで、自分以外のプログラマがソースを見た時に瞬時に理解できます。

また、開発途中で一時的にこの処理を動作しないようにするなど、コメントの使い方は様々です。

コメントアウトとは

「プログラムの中に書き込まれた、処理の記述以外の説明文のことをコメントという。」

コメントアウトを使うポイントとしては、メモとして使ったり、
プログラムを一時的に処理しない状態にしたり、
PHP Docというクラスやメソッドの定義前に決まったフォーマットでブロックコメントをすることでドキュメントを自動生成できたりします。

PHPのコメントアウトをしてみる

１行コメント `//` ・ `#`

PHP

<?php
echo 'プログラミングのテストです。出力されます1。';
//ここは１行コメントになり出力されません。

echo '出力されます２。';

# この行は１行コメントになり出力されません。

echo '出力されます3'; // ここから出力されません。

<?php

echo 'プログラミングのテストです。出力されます1。';

//ここは１行コメントになり出力されません。

echo '出力されます２。';

# この行は１行コメントになり出力されません。

echo '出力されます3'; // ここから出力されません。

ブロックコメント `/* */`

PHP

<?php
echo '出力されます1';
/*
 * このブロックは出力されません。
 * ここも出力されません。
 */
echo '出力されます2';

<?php

echo '出力されます1';

* このブロックは出力されません。

* ここも出力されません。

echo '出力されます2';

PHP Docサンプル

クラス Class

<?php
/**
 * クラスの１行説明
 *
 * クラスの詳細説明
 * 複数行記述ができます。
 *
 * @access アクセスレベル
 * @author 名前 <メールアドレス>
 * @copyright 会社名 All Rights Reserved
 * @category カテゴリー
 * @package パッケージ
 */

<?php

/**

* クラスの１行説明

* クラスの詳細説明

* 複数行記述ができます。

* @access アクセスレベル

* @author 名前 <メールアドレス>

* @category カテゴリー

* @package パッケージ

メソッド Function

PHP

<?php
/**
 * メソッドの１行説明
 *
 * メソッドの詳細説明
 * 複数行記載することができます。
 *
 * @access アクセスレベル
 * @param int    $id paramは引数を書きます。
 * @param string $name 
 * @return boolean 返り値の型と説明を書きます。
 */
function is_test($id, $name)
{
    return false;
}

<?php

/**

* メソッドの１行説明

* メソッドの詳細説明

* 複数行記載することができます。

* @access アクセスレベル

* @param int $id paramは引数を書きます。

* @param string $name

* @return boolean 返り値の型と説明を書きます。

function is_test($id, $name)

{

return false;

}

まとめ

PHPのコメントは３種類
１行コメントとブロックコメントがあります。
#コメントは非推奨だけどPythonも同じです。
PHP Docを意識して書くことでソースの共有が簡単になります。
プログラマしては、コメントが無くてもわかりやすいソースコードにすること大切です。

概要

コメントアウトとは

PHPのコメントアウトをしてみる

１行コメント // ・ #

ブロックコメント /* */

PHP Docサンプル

クラス Class

メソッド Function

まとめ

１行コメント `//` ・ `#`

ブロックコメント `/* */`