最初のPHPプログラムの書き方
著者は、 Write for DOnations プログラムの一環として、 Open Sourcing Mental IllnessLtdを選択して寄付を受け取りました。
序章
「Hello、World！」 プログラムは、コンピュータプログラミングにおける古典的で昔ながらの伝統です。 初心者向けの完全な最初のプログラムであり、システムとプログラミング環境をテストするための優れたプログラム「Hello、World！」として機能します。 プログラミング言語の基本的な構文を示しています。
このチュートリアルでは、「Hello、World！」の作成について説明します。 PHPのプログラム。 また、コード内でPHPコードブロックを開いたり閉じたり、コードでさまざまな種類のコメントを使用する方法についても学習します。
前提条件
PHPをインストールし、コンピューターにローカルプログラミング環境をセットアップする必要があります。
これを設定するには、PHP7.4のインストール方法とオペレーティングシステムのローカル開発環境の設定に従ってください。
「Hello、World！」を書くプログラム
「Hello、World！」を書くためにプログラムで、nanoなどのコマンドラインテキストエディタを開いて、新しいファイルを作成します。
- nano hello.php
ターミナルウィンドウにテキストファイルが開いたら、プログラムを入力します。
<?php
echo "Hello, World!";
?>
コードのさまざまなコンポーネントを分解してみましょう。
すべてのPHPコードは、<?phpで始まり、?>で終わるPHPコードブロックに含まれます。
echoは言語構造です。 その引数は、echoキーワードに続く式のリストであり、コンマで区切られ、括弧で区切られていません。 echoは、echoと終了セミコロン;の間に含まれるものをすべて表示または出力するようにPHPに指示します。
echoと;の間には、引用符で囲まれた一連の文字[Hello, World!）があります。 引用符で囲まれた文字は、文字列と呼ばれます。
プログラム作成後、CTRLキーを押しながらXキーを押してnanoを終了します。 ファイルを保存するように求められたら、Yを押します。
nanoを終了すると、シェルに戻ります。
これで、「Hello、World！」を作成しました。 プログラム。
「Hello、World！」を実行しますプログラム
「Hello、World！」でプログラムが作成されたら、プログラムを実行する準備が整います。 次のように、プログラムファイルの名前とともにphpコマンドを使用します。
- php hello.php
作成したhello.phpプログラムを実行すると、端末は次の出力を生成します。
OutputHello, World!
プログラムが行ったことをさらに詳しく見ていきましょう。
PHPは、言語構造echoを呼び出すことにより、行echo "Hello, World!";を実行しました。 Hello, World!の文字列値が構成に渡されました。
この例では、文字列Hello, World!は、構成や関数など、コードの別の部分に渡される値であるため、引数とも呼ばれます。
Hello, World!の両側にある引用符は、コードのこのセクションに文字列が含まれていることをPHPに通知するために使用されるため、画面に出力されませんでした。 引用符は、文字列の開始位置と終了位置を示します。
プログラムが正常に実行されたため、PHPが正しくインストールされ、プログラムが構文的に正しいことを確認できます。 コード自体をさらに詳しく説明する前に、PHPコードブロックを詳しく見てみましょう。
PHPコードブロックの外部での作業
.phpファイル内では、PHPタグの外側はすべてHTMLまたはプレーンテキストとして扱われます。 PHP言語は、もともとHTMLの機能を拡張する方法として作成されました。 これを念頭に置いて、ファイル全体に複数のPHPコードブロックを含めることができます。 コードブロックの外側にあるものはすべて、HTMLまたはプレーンテキストとしてレンダリングされます。
hello.phpファイルを更新します。
Hi Sammy
<?php echo "Hello, World!"; ?>
How are you doing?
<?php echo "Swimmingly!";
ファイルを保存して再実行します。
OutputHi Sammy
Hello, World!
How are you doing?
Swimmingly!
コードを詳しく見てみると、Hi SammyとHow are you doing?はどちらもPHPコードブロックの外側にあるため、プログラムの実行時にプレーンテキストとしてレンダリングされることがわかります。
このファイルには、2つのPHPコードブロックが含まれています。 最初のコードブロックには開始タグと終了タグの両方が含まれ、2番目のコードブロックはファイルの最後にあり、最後の終了タグを省略します。
クロージングブロックタグ?>を含める必要はありません。 PHPコードブロックでファイルを終了するときは、終了タグを省略しておくことをお勧めします。 終了タグの後にレンダリングされる空白スペースを含むすべての文字は、HTMLまたはプレーンテキストとして画面に出力されます。 リダイレクトなどの特定の機能は、ブラウザに何かが出力されている場合は処理されないため、これにより、アプリケーションの機能に予期しない結果が生じる可能性があります。 PHPコードのみを含むファイルを作成する場合は、終了PHPタグを含めないでください。
概念を複数のコードブロックに分割する場合のように、コードがより複雑になるにつれて、自分自身や他の人にメモを残すことが有益になる場合があります。 これは、コメントを使用して行うことができます。
PHPでコメントを追加する
コード内のコメントは、プログラムの一部として実行されない行です。 その唯一の目的は、コードを見ている人間が読むことです。 多くの開発者に衝撃を与える1つのことは、コードの読み取りとコードの記述にどれだけの時間が費やされるかです。 これは、できるだけ読みやすいコードが不可欠であることを意味します。 これは、いくつかの方法で実行できます。
- コーディング標準を使用します。これらは、コードを明確かつ一貫して整理およびフォーマットするためのガイドラインとベストプラクティスのコレクションです。 PHPで最も一般的なコーディング標準は、 PHP-FIG （Framework Interop Group）によって開発されたものです。
- 書き込みのしやすさよりも読みやすさを選択してください。短い変数ではなく記述変数を使用してください。 それはあなたが書いたコードの行数ではなく、誰かがそれらの行を読んで何が起こっているのかを理解するのにどれくらいの時間がかかるかということです。
- わかりやすくするためのコメント。これは難しいルールではありませんが、前の2つの箇条書きに従っている場合は、コードで何が起こっているかを説明し、コメントで説明する必要があります。 なぜ何かが今のように起こっているのか。
PHPでコメントを書く場合、コメントには1行のコメントと複数行のコメントの2種類があります。 1行のコメントは、行の任意のポイントで開始し、行の終わりまたはコードブロックの終わりのいずれか早い方で終了できます。
単一行コメントを開始する最も一般的な方法は、二重スラッシュ（//）を使用することですが、PHPはハッシュ記号（#）も単一行の有効な開始として認識します。コメント：
Hi Sammy
<?php echo "Hello"; //, World!"; ?>
How are you doing?
<?php echo "Swimmingly!";
// other options: Floating along
ファイルを保存して再実行します。
OutputHi Sammy
Hello
How are you doing?
Swimmingly!
最初のコメントは行の途中から始まります。 "Hello"の後に終了引用符とセミコロンが追加され、残りの行はコメントアウトされました。 1行以上のコードをコメントアウトすることは、特定の要素が削除された場合にコードがどのように応答するかをテストするためのデバッグでよく使用されます。
2番目のコメントを使用して、回答の2番目のオプションを指定します。 プロジェクトの次のステップは、アプリケーションを実行するたびに、いくつかの異なるオプションの1つで応答することです。 コメントは、追加される可能性のある他のオプションのリマインダーとして使用されます。
複数行のコメントは/*で始まり、*/で終わります。 PHPインタープリターは、これらの文字内のテキストまたはコードを無視します。 より多くのオプションを提供するために、最後の行を複数行のコメントに変更しましょう。
Hi Sammy
<?php echo "Hello"; //, World!"; ?>
How are you doing?
<?php echo "Swimmingly!";
/* When responding with one of a number of answers, here are some other options:
* Floating along
* Fin-tastic
* Going with the flow
* Treading water
* Swamped
*/
複数行のコメントを使用すると、詳細や書式を追加してコードをもう一度作成する余地が増え、コードの意図が理解しやすくなります。 この複数行のコメントには改行が含まれ、リストの区切り文字として*が追加されています。 */の組み合わせは、コメントブロックの終わりを示します。
ドキュメントにDocBlockを使用する
DocBlockと呼ばれる特別なタイプの複数行コメントがあります。 これは、特定のファイル、クラス、メソッド、またはその他の構造要素の機能を文書化するための独自の方法です。 DocBlockは、他の複数行コメント/* */と同様に開始および終了しますが、要素を操作するための特定の詳細を提供するように設計されています。 これらの詳細は、開発者にコードの概要を提供するだけでなく、コードエディター（またはIDE）が提案や検証を提供するために使用することもできます。
DocBlockはいくつかの部分で構成されています。 1つ目は、要素を紹介する簡単な要約と、より多くのコンテキストが必要な場合のより長い説明です。
DocBlockを一意にする最後のセクションは、タグと注釈です。 これらは、関連する要素に関するメタ情報を簡潔かつ均一に提供する方法を提供します。 タグは、たとえば、メソッドまたは関数によって受け入れられるか返される情報のタイプを説明できます。 また、ファイルの作成者または著作権に関する詳細を提供する場合もあります。
<?php
/**
* DocBlock example
*
* @author Sammy <[email protected]>
*/
...
明確でわかりやすいコードを書くように努める必要がありますが、明確なコメントを追加すると、コードの理解とコードの背後にある選択肢を増やすコンテキストを追加できます。
結論
このチュートリアルでは、「Hello、World！」を作成しました。 PHPのプログラム。 コード内でPHPコードブロックを開いたり閉じたりする方法と、コードが複雑になるにつれてコンテキストを明確にして追加するためにさまざまなコメントを使用する方法について学びました。 ここから、 PHPで文字列を操作する方法チュートリアルに従って、学習を続けることができます。
