「PHP/入門/テキスト表示とコメント」の版間の差分
削除された内容 追加された内容
== 確認方法 == PHPを使ってwebサーバのプログラムを作りたい場合、確認方法は、いくつかあります。 まず、webブラウザを使って、実際にアクセスしてみる方法です。 |
→コメント: PHPのコメントには3種類あります。 タグ: 2017年版ソースエディター |
||
125 行
ともかく、PHPのプログラムを作る場合は、PHP用のエラーログを見るためにコンソール端末でも動作を確認しましょう。
== コメント
PHP
;[https://paiza.io/projects/5wTgfL6I4G_b00Ea6NP5Eg?language=php 例]:<syntaxhighlight lang=
<?php
declare(strict_types=1);
?>▼
</syntaxhighlight>▼
// // から行末まではコメントです。
echo "Hello", /* このように範囲でもコメントが書けます。 */ " World", PHP_EOL;
# シェルのように # から行末までもコメントです。
▲?>
▲</syntaxhighlight>
;実行結果:<syntaxhighlight lang=text>
Hello World
</syntaxhighlight>
コメントは、プログラムのデーターやロジックに影響を与えず、自由な文書をプログラムに含めることができます。
コメントには、なにを書いてもいいのですが、プログラムのロジックをそのまま記すのは、冗長であるうえにコードの変更にコメントが追従せずズレが生じる原因になります。
次のような要素がコメントによく書かれます
* 著作権者
* コピーライト
* ライセンス
* 参照した論文の DOI
* 関数の引数と戻値の型
** 型宣言仕様が追加されて以降は不要?
* 変数や定数の型
* XXX
** 検証が必要
=== PHPDoc ===
[TODO]
|