## PHPの習得は実は難しいのか？

Web系開発をしていく中で欠かせないHTMLやCSS、JavaScriptと並び、需要が高い言語がPHPです。

同開発に興味を持っている方はPHPについて知っているとは思いますが、実際の習得難易度はどの程度なのでしょうか。多くのWebサイトでは初心者向け、簡単などと紹介されているPHPは本当にその通りなのでしょうか。

本記事では、**PHPの習得メリットをおさらいしつつ、簡単と言われているPHPでも難しいと思われるポイントを解説します。**

PHPとは？基本知識からメリット・デメリットまでわかりやすく解説

## Webに特化した知識要求や自由度の高さがネック

結論から言えば、PHP自体は文法がシンプルで、コーディングの自由度も高く、難しい言語の部類には入りません。しかし一方で、*その自由度の高さゆえに可読性の低いコードが生まれやすく、既存コードの理解と改修が難しくなる傾向があります。*

また、Webに特化した言語ゆえ、Web開発の専門知識を強く求められ、動作確認にサーバ構築も必要です。そういった点は、*プログラミング経験者でもWebとは無縁の業種であった場合には、つまずきやすいポイントになりうると言えるでしょう。*

<center>[エンジニア転職を成功させるため<br/>ぜひ*『マイナビIT エージェント』*をご活用ください！](https://mynavi-agent.jp/it/?utm_source=and-engineer&utm_medium=content-text&utm_campaign=acv07_2)</center>

## PHPが難しいと感じるポイント

早速、本題である難しいポイントを解説していきます。主にプログラミング経験者であっても苦戦しがちな点を紹介します。

### 自由度が高く可読性の低いコードができやすい

PHPが初心者向けで簡単と言われている理由に、文法がシンプルであることが挙げられます。その中での大きな特徴として、変数を使用する際に型の宣言が不要な点があります。

一見すると自由な設計を可能にする便利な仕様ですが、好き勝手な実装でも動作してしまい、思わぬバグが潜んでいる可能性があります。また、*他者が実装したコードを引き継いだ際、こうした自由な設計が仇となり、処理の全貌や詳細が把握しづらくなることがあるでしょう。*

こうした可読性の低下が起きやすいPHPでは、今まで使っていた言語と勝手が異なり難しく感じる方もいるでしょう。

PHPはサーバサイドで動作する言語であるため、動作確認にはサーバ構築が必要です。サーバ構築はHTMLなどに慣れ親しんだWeb開発経験者にとっては、取り立てて難しいことではありません。

しかし、Web開発とは無縁の業種のエンジニアから見ると難しく感じる可能性があります。*全くの異業種から参入した方にとっては、例えプログラミング経験者であっても独特の手順や用語に苦戦し、PHPを難しいと感じてしまう要因になりえるでしょう。*

### PHP以外の言語やWeb開発の知識も学習する必要がある

開発環境の構築で必要なように、PHPを習得していく上ではWeb開発全般の知識が必要です。それに加え、PHP以外の言語も習得しなければならない点も難易度が高いポイントです。

PHPはHTMLを動的に生成できるため、前提としてHTMLやCSSを使いこなせる必要があります。これらは確かにシンプルで、難しい言語とは言えません。しかし、*プログラミングの概念とは別に覚えておかないといけない知識が多く、Web開発未経験ならば慣れるまで時間がかかるはずです。*

さらに、言語とは別にWeb開発特有の用語や概念を知らなければ、PHPを活かしたWebページを作ることはできません。このように前提となる知識量が多くなる点は難易度を高く感じてしまう要因となりえます。

続いて、PHPを習得するメリットについて紹介します。PHPはほとんどの場合、Web開発で使用されているため、Web系に特化した形のメリットが中心です。

### 多彩なWebサイトを作成できる

PHPを習得することで、HTMLやCSSだけでは難しい多彩なWebサイトを作成できるようになります。PHPはサーバサイドで実装される言語であり、動的にHTMLのページを生成し、クライアント側へ提供できることが大きな特徴です。

そのため、例えばECサイトや予約サイト、掲示板、問い合わせページなどを作成することが可能です。*こうしたサイト作成は企業が提供するWebサイトには必要不可欠であり、実装できる実力と経験はWeb系開発をしていくにあたって、有利に働くでしょう。*

### データベース管理システムと連携できる

PHPは上記のような動的ページを作成できるだけでなく、データベース管理システムとの相性が良いところもポイントです。

相性の良い例として、オープンソースのリレーショナルデータベースシステムであるMySQLがあります。PHPにはこうしたデータベースと接続し、やりとりを行うための処理が実装されており、容易に操作を行うことが可能です。

近年注目されているビッグデータはその膨大さから、データベースで管理することが必要不可欠です。そのため、*PHP習得を通してデータベースに関する知識も身に付ければ様々な場面で活躍できるでしょう。*

【参考】：[MySQL](https://www.mysql.com/jp/)

MySQLとは？特徴から使い方・学習方法まで詳しく解説！

### Web系開発における需要が高い

ここまでで述べたようにPHPはWeb開発において非常に重要な役割を担っています。インターネットが生活になくてはならない現代社会では、Web開発はますます需要が高まり、PHPもそれにならって需要は高まっていくでしょう。

Web開発における言語のトレンドを調査しているW3Techの調査によれば、2024年2月現在、PHPはサーバサイド言語の中で76.5%を占めていることがわかります。これだけのシェアを持ったPHPを習得すれば、開発や保守を含めた様々な案件が視野に入ります。

結果、Web業界におけるキャリアを有利にすることができるでしょう。

加えて重要な点が、*CMSの中でも極めてメジャーなWordPressでPHPが採用されていることでしょう。*多くのWebサイトがWordPressで作られている今、PHPを習得することでWordPressに関する案件にも対応できるようになります。

【参考】：[W3Techによる2024年2月時点のサーバーサイド言語のシェア](https://w3techs.com/technologies/history_overview/programming_language)

こうしたメリットのあるPHPエンジニアは、どの程度の年収が期待できるでしょうか。厳密には異なりますが、Web開発における代表的なエンジニアであるフロントエンドエンジニアを参考に、その年収を見ていきます。

フロントエンドエンジニアの年収は「マイナビエージェント 職業別年収ランキング」での平均年収は385万円（※2024年2月執筆時点）、経済産業省2017年発表の「IT関連産業の給与等に関する実態調査結果」から近い職種のコンテンツクリエイタ/デザイナーを参考にすると、平均年収411万円と分かりました。

国税庁2020年発表の「民間給与実態統計調査」における民間企業平均年収は433万円なので、フロントエンドエンジニアは企業や業種によって年収にばらつきがありますが、やや低めの年収であると言えます。

フロントエンドエンジニアに限らず、コーディング担当は下流工程であるので、報酬も低くなりがちです。しかし、*Web開発におけるプランナーなどの上流工程にキャリアアップできれば、成長市場でもあるため高い報酬を得ることもできるでしょう。*

【参考】：[マイナビエージェント 職業別年収ランキング](https://mynavi-agent.jp/helpful/income/category/creative_05.html?utm_source=and-engineer&utm_medium=content-text&utm_campaign=acv07_2)
※【平均年収 調査対象者】 2015年〜2016年末までの間にマイナビエージェントにご登録頂いた20代・30代の方
【参考】：[IT関連産業における給与水準の実態① ~ 職種別（P7）](https://warp.da.ndl.go.jp/info:ndljp/pid/11623215/www.meti.go.jp/press/2017/08/20170821001/20170821001-1.pdf) 
【参考】：[民間給与実態統計調査-国税庁](https://www.nta.go.jp/publication/statistics/kokuzeicho/minkan2020/pdf/002.pdf)

PHPエンジニアとは？仕事内容や目指すためのロードマップを解説

## PHPを学習していくにあたってのポイント

前述のようにPHPの難しいと考えられる点はいくつかあります。最後にPHPを習得するにあたってのポイントを解説します。

プログラミング言語を学んでいくにあたって多くの方が気になる点は、どこまで学べば基礎を学んだことになるかでしょう。

PHPの場合を考えてみるにあたり、学習サイトであるProgateが参考になります。同サイトのPHP学習レッスンを見ていくと、変数や条件分岐など共通して基礎と言える内容に加えて、お問い合わせフォームの作成が存在しています。

このように、*PHPを使って実際にユーザ操作が可能なページを作るところまでが基礎と言えるのではないでしょうか。*

【参考】：[ProgateのPHP入門](https://prog-8.com/lessons/php/study/1)

Progateが終わったら何をすればいい？おすすめの勉強方法4選を紹介

### Javascriptとどっちが難しい？

PHPと同様にWeb開発で幅広く使われている言語がJavaScriptです。この2つはどのような違いがあり、どのように使い分けられているのでしょうか。

大きな違いは、プログラムが実行される場所です。PHPはサーバサイド言語であり、Webページを提供するサーバ側でプログラムが実行されます。一方で、JavaScriptはクライアントサイド言語であり、Webページにアクセスするユーザ側でプログラムが実行されます。

つまり、*PHPはサーバ側のデータを元にした動的な動作が期待され、JavaScriptはページのアニメーションなどサーバ側の状態に依存しない動作が期待されることが多いと言えます。*

JavaScriptの特徴とは？何ができるのか、メリット・デメリットも解説

## 習得したPHPをキャリアに活かすためには

本記事ではPHPがプログラミング経験者であっても難しく感じるポイントについて解説しました。**初心者向けと言われていても、決して油断のできない言語であることがわかりました。**

一方で、成長市場でもあるWeb業界におけるキャリアチェンジを目指し、PHPを学習していきたいと考えた方もいると思います。

PHPを習得し、Web開発に携われる実力を身に付けられたら、どのようにしてキャリアチェンジを目指せばいいでしょうか。数ある求人サイトの中から自分に合った企業を探していくことは容易ではありません。

そこでぜひご活用いただきたいのが[マイナビIT エージェント](https://mynavi-agent.jp/it/?utm_source=and-engineer&utm_medium=content-text&utm_campaign=acv07_2)です。

マイナビIT エージェントは、IT・Webエンジニア向けの無料の転職⽀援サービスです。

IT・Webエンジニアの転職事情に詳しいキャリアアドバイザーが、あなたのご経験やスキルをお伺いし、転職活動のプランをご提案致します。

アドバイザーは企業側の人事担当者と直接連携を取れますので、求人票に載っていない企業情報も確認することができます。残業時間や給与面など、働き方などをしっかり確認の上で応募企業を選んでいくのが良いでしょう。

・資格やプログラミングの勉強をしているけれど、企業が求めるレベルに達しているのかわからない
・スキルアップをして市場価値を上げていける企業の選び方を知りたい
・数多くあるITエンジニアの職種の中で、自分に向いている仕事は何か知りたい

こうした悩みを抱えていらっしゃる方は、まずは無料登録でキャリアカウンセリングをおすすめ致します。

<center>[あなたに合った企業選びをサポート致します。<br/>エンジニア転職のご相談はぜひ<br/>*『マイナビIT エージェント』*へ！](https://mynavi-agent.jp/it/?utm_source=and-engineer&utm_medium=content-text&utm_campaign=acv07_2)</center>

PHPはWeb開発において幅広く使われており、初心者向けという声も聞かれています。しかし、実際のところ、プログラミング経験者でも難しいと感じる箇所はあります。本記事では習得のメリットを紹介しつつ、その難しい点を解説します。

PHPはシンプルかつ自由度が高いゆえに可読性の既存コードが存在し、難しく感じることがある

PHP学習の過程でHTMLなどの他言語やWeb特有の知識を身に付けなければならない点が難しい

PHPはサーバーサイド言語では7割強を占めており、需要は十分にある

PHPの習得は難しい？エンジニア経験者でも苦戦する理由を解説

## PHPはWebサイトの作成に必須？

PHP（Hypertext Preprocessor）は、Webサイトの構築で広く使用されているサーバーサイドのスクリプト言語です。Webサイトを構成する言語としてはHTMLやCSS、JavaScriptが基本ですが、*PHPが加わることでより効率的に、より魅力的なWebサイトの構築が可能になります。*

では、Webサイトを作る上でPHPは必須なのでしょうか？他の言語で代用はできないのでしょうか？

この記事では、「PHPはWebサイトの作成に必須なのか」と題して、Webエンジニアを目指す方の素朴な疑問に答えます。

【参考】：[PHP: ハイパーテキスト プリプロセッサ](https://www.php.net/)

PHPはWeb作成のための言語として大変人気の高い言語です。はじめに、PHPの特徴と用途について確認しておきましょう。

PHPでできること7選！作品例やアプリ、将来性についても解説

**PHPはWeb開発に特化しており、初心者でも比較的学びやすい言語です。**Webアプリ開発を目指す方はぜひ習得しておきたい言語の1つです。以下、その特徴を見ていきましょう。

*1.動的型付け言語*
PHPは「動的型付け言語」に分類されます。変数のデータ型を事前に指定する必要がなく、柔軟なプログラミングが可能です。ただし、コードが増えると変数の内容が分かりにくくなることもあります。PythonやRubyも同じカテゴリに属します。

*2.Webに動きをつけられる*
PHPは元々Webページに動きをつけるために開発されたサーバーサイドの言語であり、Web開発に特化しています。Webページの作成に利用されるマークアップ言語のHTMLでは静的サイトの作成しか行えず、動的なページを作成するためにはJavaScriptやPHPが必要です。

JavaScriptに関してはクライアント側のみで動作します。

*3.充実したWebフレームワーク*
PHPには多くのWebフレームワークが存在します。例えば、Laravelは非常に人気で、LaravelのテンプレートエンジンであるBladeを使うことで、より効率的にWebアプリケーションを開発できます。

【参考】：[Laravel ｜The PHP Framework For Web Artisans](https://laravel.com/)

PHPのおすすめフレームワーク5選！学習方法も併せて解説

PHPフレームワークLaravel入門！使い方や入門書も解説

*4.HTMLとの連携*
PHPは動的にHTMLを生成するために使われます。HTMLで記述されたファイルの中に埋め込んで使えるため、HTMLとPHPは1つのファイルとしてまとめられ便利です。また、PHPはJavaScriptと組み合わせてWebページを生成することもできます。

【参考】：[JavaScript | MDN](https://developer.mozilla.org/ja/docs/Web/JavaScript)

*5.ECサイトやSNSの開発*
PHPを利用することで自前のECサイトやSNSを作成できます。ログイン機能や商品閲覧ページ、ショッピングカート、SNSのチャット機能など、幅広い用途に利用できます。

*6.WordPressのカスタマイズ*
Webサイトやブログの作成に使われるツール、WordPressはPHPで作成されています。PHPやHTMLを習得することで、より高度なカスタマイズが可能になります。

PHPはWebサイトの構築に適した言語ですが、**具体的にはどのようなサイトの構築に適しているのか、事例を交えて解説します。**

*1. 企業のWebサイト*
PHPを使って、会社のWebサイトを作成できます。多くのWebサイトはPHPで作られたツールのWordPressで構築されています。

*2. ショッピングサイト*
PHPを使用してECサイト（ショッピングサイト）を作成できます。会員情報の管理、商品の購入、決済処理など、ECサイトに必要な機能をPHPで実現できます。

*3.SNS*
PHPを使ってSNSを作成できます。有名な例としては「Facebook」があります。

*4.予約サイト*
PHPで予約サイトを作成できます。病院や宿泊予約やレストランの予約など、予約可能な時間帯や空き状況を自動的に判定して公開できます。

*5.クラウドファンディングサイト*
PHPを使ってクラウドファンディングサイトを作成できます。日本最大のクラウドファンディングサイト「CAMPFIRE」もPHPで開発されました。

*6.フリーマーケットサイト*
PHPを使ってフリーマーケットサイトを作成できます。例えば、「ココナラ」はスキルを売り買いできるサイトで、PHPで構築されています。

*7.業務効率化システム*
PHPを使って業務を効率化するためのシステムを作成できます。例えば、生産性向上に役立つ「Slack」もPHPで作られています。

*8.コンテンツ管理システム*
PHPを使ってコンテンツ管理システム（CMS）を作成できます。CMSはWebサイトのコンテンツを一元的に保存・管理するシステムで、PHPで構築されたものも多くあります。

PHPの入門として概要やプログラムの記載方法、文法について解説

PHPはWebサイト制作において非常に有用な言語であり、利用するメリットが多くありますが、一方でデメリットもあります。このメリットとデメリットをよく理解した上で適切に利用することが大切です。

PHPには以下に挙げるようなメリットがあります。**PHPを学ぶ側としては、習得や利用環境が整っている点は大きなメリットです。**

*1. 習得までの難易度が低め*
PHPは比較的習得しやすい言語であり、プログラミング未経験者でも学びやすいのが特徴です。環境設定も手間がかからず、Web系エンジニアとしてスキルを身につけたい方に適しています。

*2.情報が豊富にある*
PHPは歴史のある言語で、多くのサンプルコードやチュートリアルがインターネット上で公開されています。またPHPによるホームページの作り方の本は豊富に揃っており、学習環境が整っています。

*3.動作確認がしやすい*
PHPはインタプリタ型言語であり、ソースコードをコンパイルせずに実行できるため、動作確認がしやすいです。

*4.フレームワークで開発時間を短縮できる*
PHPには開発を効率化するフレームワークが豊富に用意されています。よく知られたものとしては「Laravel」「CakePHP」「Symfony」などがあります。

【参考】：[CakePHP 4](https://book.cakephp.org/4/ja/index.html)
【参考】：[Symfony Documentation](https://symfony.com/doc/current/index.html)

*5.多くのレンタルサーバーが対応している*
PHPは一般的なWebホスティングサービスでサポートされているため、実際のWebサイトで利用できます。

*6.案件が豊富*
PHPエンジニアの需要は高く、多くのWebプロジェクトで活躍できる可能性があります。

大変利用しやすいPHPですが、以下のようなデメリットもあります。デメリットを理解した上で習得に努めましょう。

*1.自由度が高過ぎる*
PHPは文法の自由度が高いため、バグの発生リスクがあります。エンジニアによって記述が異なりやすいことに注意が必要です。**組織で利用する際は標準化をしておくとよいでしょう。**

*2.アプリ開発には利用しにくい*
PHPは主にWebアプリケーションやWebサイトに特化した言語であり、スマートフォンアプリなどの開発には向いていません。

## PHPを利用せずに同等のサイトの構築は可能？

ここまでPHPの特徴や用途、メリットやデメリットについて解説しました。実はPHPを利用せずともWebサイトの構築は可能です。ここでは、具体的にどのような方法があるのか見ていきましょう。

PHPはサーバーサイドのスクリプト言語であり、Webサーバー上で実行されます。同様に、JavaScriptはクライアントサイドのスクリプト言語であり、Webブラウザ上で実行されます。

**JavaScriptのフロントエンドフレームワーク（例：React、Angular、Vue.js）を使用して、クライアント側のロジックを構築できます。**これにより、PHPの代わりにJavaScriptを使用してWebサイトを構築できます。

【参考】：[React](https://ja.react.dev/)
【参考】：[Angular 日本語版](https://angular.jp/)
【参考】：[はじめに | Vue.js](https://ja.vuejs.org/guide/introduction)

Reactの将来性はVue超え？できることやメリット・デメリットも解説

Vue.jsとは？すぐに分かる概要から特長・使い方まで解説！

### サーバーレスアーキテクチャを使用する

「AWS Lambda」や「Google Cloud Functions」などのサーバーレスアーキテクチャを使用して、バックエンドの機能を実装できます。これにより、**PHPの代わりにサーバーレス関数を使用してWebサイトを構築できます。**

【参考】：[AWS Lambda の概要 ｜AWS Lambda](https://docs.aws.amazon.com/ja_jp/lambda/latest/dg/welcome.html)
【参考】：[Cloud Functions のドキュメント  |  Google Cloud](https://cloud.google.com/functions/docs?hl=ja)

AWS Lambdaとは？できることを分かりやすく解説！

### 他のスクリプト言語を利用する

**PHP以外のPythonやRubyなどのスクリプト言語を使用して、Webサイトを構築できます。**これらの言語はPHPと同様にサーバーサイドのロジックを実行できます。

【参考】：[Welcome to Python.org](https://www.python.org/)
【参考】：[オブジェクト指向スクリプト言語 Ruby](https://www.ruby-lang.org/ja/)

Pythonとは？人気の理由と基本知識をわかりやすく解説！

Rubyとは何か？Rubyの特徴やできることについて解説

## Webエンジニアを目指すならPHPを習得しよう

ここまで、PHPを使わずにWebサイトは構築可能というテーマで、PHPの特徴や用途、メリットやデメリット、PHPを使わずにWebサイトを構築する方法について解説しました。PHPを利用せずとも、PHPと同等のWebサイトを構築することは可能です。

とはいえ、決してPHPが不要ということではありません。PHPは広く利用され、尚且つWeb開発手法も確立しており、Web構築に長けた言語として定着しているからです。そのため、**Webエンジニアを目指す人は、HTMLとCSS、JavaScriptに加え、PHPも習得しましょう。**

PHPの正規表現は？仕様から用法・サンプルまでくまなく解説！

PHPデバッグ用のインデックスや関数などを開発に活用する

PHPのおすすめ本13選！入門レベルからさらに学べる学習本まで解説

PHPはWebサイトの作成に必須なのでしょうか？実際にPHPによってさまざまな著名なWebサイトが作られ、PHPエンジニアに対する需要が高いのは事実です。この記事では、PHPの概要やメリット、PHPを使わずに同等のWebサイトを作る方法などを紹介していきます。

PHPはWebサイトの構築に特化した、優れた開発言語であり、さまざまな利用メリットがある

PHPを利用しなくとも、同等のWebサイトを作る方法はいくつかある

Webエンジニアを目指すなら、HTMLとCSS、JavaScriptに加えPHPを習得するとよい

PHPはWebサイトの構築に必須？特徴やメリット、他の構築方法も解説

PHPは、サーバーサイドのウェブプログラミングで用いられる汎用プログラミング言語です。HTMLに埋め込んで使用されるなど、HTMLのプリプロセッサとして実績があります。**PHPはソースコードのメンテナンスのために、多くのコメント機能が実装されています。**

ここでは、PHPのコメントアウトの概要から使い方まで解説していきます。

【参考】：[PHP](https://www.php.net/)

### そもそもコメントアウトとは

*コメントアウトとは、プログラミングにおいて、ソースコードのデバッグコードなど不要なコードを無効化したりコードの説明文を注釈として記述したりすることです。*PHPではコメントアウトするために、言語仕様にコメント機能を定義して対応しています。

### PHPにおけるコメントアウトの活用方法

通常、ブラウザで「ページのソースを表示」を選択すると、HTMLではコメントアウト部分も表示されます。*PHPは、動的コンテンツを生成するため、PHPでコメントアウトした部分はHTMLのコードには表示されません。*

ソフトウェア開発のバージョン情報や変更内容など、情報流出が心配な場合は、PHPのコード部分にコメント機能で注釈を入れることで、コメントの非表示化が可能です。

## PHPのコメントアウトの種類と使い方

PHPのコメント機能はいくつかあります。*主要なものは、C++型の単一行用のコメント、シェル型の単一行用のコメント、複数行用のコメントの3種類です。*まず最初は、これら3種類のコメント機能を学んでいきます。

【参考】：[PHP マニュアル / 言語リファレンス / 基本的な構文 / コメント](https://www.php.net/manual/ja/language.basic-syntax.comments.php)

### C++型の単一行用のコメント機能

*C++型の単一行用のコメント機能は、”\/\/”を先頭に記述するコメントアウト形式です。*”\/\/”は行頭に記述したり、各行の右側に追記したりして使用します。このコメントアウト形式は、行単位で記述します。

使い方は、次のように行います。

```
<?php
echo 'Hello World';   // ここにコメントを記述します
?>```

### シェル型の単一行用のコメント機能

*シェル型の単一行用のコメント機能は、”#”を先頭に記述するコメントアウト形式です。*”#”は行頭に記述したり、各行の右側に追記したりして使用します。このコメントアウト形式は、C++型同様に行単位で記述します。

```
<?php
echo 'Hello World';   # ここにコメントを記述します
?>```

*複数行をまとめてコメントアウトするには、複数行用に提供されるコメント機能を用います。*”\/\*”でコメントが開始し、”\*\/”で終了します。単一行でも使用できますが、複数行にわたるプログラムをコメントアウトしたり、説明用の注釈を入れたりする際に利用するのが良いでしょう。

```
<?php
/*
ここにコメントを記述します
   ：
   ：
*/
?>```

### 複数行用のコメント機能の留意点

複数行用のコメントは、”\/\*”の後の”\*\/”で終了します。*複数行用コメントの入れ子はできません。*次のように記述すると、コメント終了が正しく解釈されずエラーとなります。

```
<?php
/*
echo 'Hello World';  /* このコメント終了の文字が入れ子になってしまい、エラーとなります */
*/
?>```

正常にコメントアウトするには、次のように行ごとのコメントアウトにおいて、単一行用のコメント機能を使います。

```
<?php
/*
echo 'Hello World'; // このコメントは問題ありません
echo 'Hello World'; # このコメントは問題ありません
*/
?>```

### 3種類のコメント機能を使い分ける

これまでに、PHPでは主要な3種類のコメント機能があることがわかりました。*それぞれのコメント機能の利用方法には明確な制限がありませんが、プロジェクトなど大規模なソフトウェア開発においては、コメントアウトのルール決めをしておきましょう。*

例えば、次の例のようにPHPの大見出しをつけたり、後述するドキュメントコメントを埋め込んだりします。個々の注釈は単一行用のコメント機能を用いるのが良いでしょう。

```
<?php
//
// 大見出しをつける
//
 
/**
 * ドキュメントコメント（後述します）
 * 提供する機能の概要や、
 * 使用方法などを記載する
 */
 
// デバッグコードを次のようにコメントアウトする
# echo 'Test';
?>```

### 正規表現でコメント機能を利用する

*PHPでは、正規表現においてもコメント機能を利用することができます。*”(?#”と”)”で囲った部分がコメントアウトされて処理されます。以下の例では、正規表現中にコメント機能で注釈をいれていますが、検索パターンから除外されるため、同じ文字列パターンとして処理が行われます。

```
<?php
$subject = 'Search Pattern';
$results = preg_match('/Search (?# この部分はコメントアウトされます)Pattern/', $subject);
var_dump($results);
?>```

【参考】：[PHP マニュアル / 関数リファレンス / テキスト処理 / 正規表現 (Perl 互換) ](https://www.php.net/manual/ja/book.pcre.php)
【参考】：[PHP マニュアル / 関数リファレンス / テキスト処理 / PCRE / PCRE のパターン / PCRE 正規表現構文 / コメント](https://www.php.net/manual/ja/regexp.reference.comments.php)
【参考】：[PHP マニュアル / 関数リファレンス / テキスト処理 / PCRE / PCRE 関数 / preg_match](https://www.php.net/manual/ja/function.preg-match.php)

また、PCRE_EXTENDEDオプションを設定することで、”#”以降をコメントとしてパターンから除外することもできます。

```
<?php
$subject = 'Search Pattern';
$results = preg_match('/Search # この部分はコメントアウトされます
Pattern/', $subject);
var_dump($results);
?>```

【参考】：[PHP マニュアル / 関数リファレンス / テキスト処理 / PCRE / PCRE のパターン / パターン修飾子](https://www.php.net/manual/ja/reference.pcre.pattern.modifiers.php)

ドキュメントコメント（DocComment）とは、”\/\*\*”で始まり”\*\/”で終わるコードのコメントを指します。*クラスや関数などの機能や引数、戻り値などを記載するコメントです。*次のようにコードの前に、記述しておきます。

```
<?php
/**
 * Debug Class / デバッグ用クラス （概要を記載）
 * （必要な詳細情報を追加）
 *
 * ＠param int $number　（名前や引数など）
 * @return array | bool　　（戻り値など）
 */
class DebugClass {}
 
$RefC = new ReflectionClass('DebugClass';
var_dump($RefC->getDocComment());
?>```

このようにソースコードの保全性を高めるために、コメントを残すなどのルール付けをするのが良いでしょう。上記サンプルコードで使用したgetDocComment()は、ドキュメントコメントを取得する関数です。コードのメンテナンスに使用すると良いでしょう。

【参考】：[PHP マニュアル / 関数リファレンス / 変数・データ型関連 / リフレクション / ReflectionClass / ReflectionClass::getDocComment](https://www.php.net/manual/ja/reflectionclass.getdoccomment.php)
【参考】：[PHP マニュアル / 関数リファレンス / 変数・データ型関連 / リフレクション / ReflectionProperty / ReflectionProperty::getDocComment](https://www.php.net/manual/ja/reflectionproperty.getdoccomment.php)
【参考】：[PHP マニュアル / 関数リファレンス / 変数・データ型関連 / リフレクション / ReflectionClassConstant / ReflectionClassConstant::getDocComment](https://www.php.net/manual/ja/reflectionclassconstant.getdoccomment.php)
【参考】：[PHP マニュアル / 関数リファレンス / 変数・データ型関連 / リフレクション / ReflectionFunctionAbstract / ReflectionFunctionAbstract::getDocComment](https://www.php.net/manual/ja/reflectionfunctionabstract.getdoccomment.php)

PHP8からアトリビュート（Attribute）機能が追加されています。Javaにおけるアノテーションに相当する機能です。*コードの宣言時にメタデータ情報を埋め込むことができます。*メタデータの定義と活用を分離することで、ライブラリやフレームワークへの実装が期待されています。

アトリビュートを定義するには、”#[Attribute]”でクラスを宣言します。利用するには”#[クラス名]”です。PHP7まではそのまま”#”で始まるコメントとして解釈されます。

アトリビュート機能は、行頭の”#”を用いて機能追加していますので単一行用のコメント機能の”#”を多様するコードでは、コンフリクトに注意する必要があります。例えば、PHP8以降では”#[コメント]”の様なコードは、シンタックスエラーとなります。

よりコードの安定性を高めるには、コメントの行頭で用いる”#”をあらかじめ”\/\/”に置き換えておくと良いでしょう。

【参考】：[PHP マニュアル / 言語リファレンス / アトリビュート](https://www.php.net/manual/ja/language.attributes.overview.php)

### エディタで一括コメントアウトするには

*統合開発環境（IDE）やエディタでは、コメントアウトするためのショートカットキーが設定されています。*例えばVSCode（Visual Studio Code）では、Windows版では単一行コメントが「Ctrl」+「/」に設定され、複数行コメントが「Shift」＋「Alt」+「A」にマッピングされています。

詳しくは利用中のエディタのドキュメントを確認しましょう。

【参考】：[Visual Studio Code: Keyboard shortcuts for Windows](https://code.visualstudio.com/shortcuts/keyboard-shortcuts-windows.pdf)
【参考】：[Visual Studio Code: Keyboard shortcuts for macOS](https://code.visualstudio.com/shortcuts/keyboard-shortcuts-macos.pdf)
【参考】：[Visual Studio Code: Keyboard shortcuts for Linux](https://code.visualstudio.com/shortcuts/keyboard-shortcuts-linux.pdf)

IDEとは？詳細やメリット、おすすめのIDEを紹介します！

VSCodeとは？定番のコードエディタを他のエディタと比較して解説

## HTMLのコメント機能を併用するには

*PHPをHTMLファイルに埋め込む場合は、コメント機能を使い分けします。*正しくコメントアウトされない場合や、予期せずにコメントアウトされる場合は、使用方法を混同していることが想定されます。

ポイントは、HTMLのコードではHTMLのコメント機能を使用し、PHPのコードではPHPのコメント機能を使用することです。以降で解説するように、PHPでHTMLのコメント機能を使用したりHTMLでPHPのコメント機能をしたりするとコメントアウトされません。

### PHP内でHTMLのコメント機能を使用した場合（誤りの例）

*PHP内でHTMLのコメント機能を使用した場合は、PHPがHTMLのコメントを解釈できずコメントアウトされません。*次の例は、PHPのコード部分にHTMLのコメント機能を入れた例であり、正しくコメントアウトできません。

```
<?php

?>```

### HTMLコード部分でPHPのコメント機能を使用した場合（誤りの例）

*HTMLコード部分でPHPのコメント機能を使用した場合も、正しくコメントアウトされません。*次の例は、実際のコードでHTMLのコードにPHPのコメント機能を用いた場合です。この場合は、HTMLのタグとして正しく解釈されません。

```
/*
<?php
echo 'Hello World';
?>
*/```

### HTMLのコードでPHP全体をコメントアウトするには

*HTMLのコードでPHP全体をコメントアウトするには、PHPの複数行用のコメント機能を使用します。*次の例は、実際にPHPのコード全体をコメントアウトした場合の例です。この場合は、PHPのパーサーは正しくコメントとして解釈し、実行コードから除外します。

PHPの記事（1ページ目）