PHP（Laravel）の開発を始めるときに知っておきたいこと 2020

仕事で PHP のプロダクトのリビルトを行っていて、 PHP 開発を始めるために必要なことを整理したので、ブログでも公開しておきます。

PHP のプロダクトを開発しているチームに、新しい人が Join したときなどに使えます。

知っているところは読み飛ばして、知らないところだけ読んだら良いです。

もくじ

PHP の文法について

基本的な構文は以下のリファレンスを読んで下さい。

• https://www.php.net/manual/ja/langref.php

Composer

PHP ではパッケージ管理ツールに Composer を使います。Node.js の npm みたいなものです。

Composer について基本的なことは以下の記事を読むと良いです。

• PHP開発でComposerを使わないなんてありえない！基礎編 - Qiita

Composer の公式サイトはこちら

• https://getcomposer.org/

Laravel

Laravel は PHP のスタンダードな Web フレームワークです。今導入するなら Laravel 以外の選択肢はあまりないかなと思います。

導入方法はやドキュメントはこちらになります

• https://readouble.com/laravel/6.x/ja/installation.html

コーディング規約

PHP は、 PHP-Fig という団体によって、様々な規約が決められています。規約には PSR-(数字) という識別子がついています。

• https://www.php-fig.org/

コードを書くのに重要なコーディングスタイルに関する規約は以下の3つです。この3つは覚えておく必要があります。

• コーディング規約
  • PSR-1 https://www.php-fig.org/psr/psr-1/
  • PSR-12 https://www.php-fig.org/psr/psr-12/
    • PSR-1 が基本的なコーディング規約、PSR-12 は、 PSR-1 より細かい点について書かれた規約です。両方守るようにしましょう。
• Autoloading（namespace とディレクトリ構造・ファイル名に関する規約）
  • PSR-4 https://www.php-fig.org/psr/psr-4/

PHPCS

PHPCS （PHP_CodeSniffer）というツールで、コーディング規約に準じているかチェックできます。

phpcs.xml でどのようなチェックをするか定義します。

Laravel には標準では入っていないので、Composer でインストールして、設定ファイルを書く必要があります。

• https://github.com/squizlabs/PHP_CodeSniffer

PHP_CodeSniffer を IntelliJ や Jenkins から使う方法はこちらの記事にまとまっているので、気になる人は読んでください。

www.utakata.work

PHPUnit

ユニットテストには PHPUnit というツールを利用します。

Laravel のドキュメントにもあります。

• https://readouble.com/laravel/6.x/ja/testing.html

PHPDoc

PHP のコードにドキュメントを書くときは、PHPDoc 形式で書くと、ドキュメントが生成できたり、IDEによるサポートが受けられるので便利です。

• https://zonuexe.github.io/phpDocumentor2-ja/references/phpdoc/index.html

Guzzle

Guzzle は HTTP リクエストをするためのライブラリです。

• https://docs.guzzlephp.org/en/stable/quickstart.html

問題解決力を鍛える!アルゴリズムとデータ構造 (KS情報科学専門書)