はじめに こんにちは。kouです。 前回の記事を書いてから2年が経ちました。🤔 現在自分が開発に携わっている マナリンク では、バックエンドにLaravelを使用しています。 今年に入ってから、PHPStan（PHPの静的解析ツール）が導入されることとなり、現在はレベル6で運用に載っています。 PHPStanのレベルが6に上がったことを受けて、型宣言周りをより詳細に書く必要が出てきました。 PHPでは、配列の型を言語仕様レベルではarray型としか書くことができず、それが数値の配列なのか、オブジェクトの配列なのか、はたまた連想配列なのかをこの型自体から読み取ることは難しいため、「この引数（あるいは返り値）のarray型は何が来るんだ？」という思いを抱いたことがある方は多いかと思います。 例に漏れず自分もその一人であり、今後PHPStanのレベル6(もしかしたらそれ以上)の中で開発を進めて
型を使いこなすためのPHPDocの書き方 - RAKUS Developers Blog | ラクス エンジニアブログ
はじめに こんにちは、takaramです。 今回はPHPDocについて、特に型の重要性と、応用的で便利な書き方をご紹介したいと思います！ はじめに PHPの型を使いこなしたい PHPDocとは？ PHPDocの仕様 多くのツールで有効なPHPDocの書き方 型の書き方 配列型 false型 @property ローカル変数の型 まとめ おまけ：配配メール開発チームの取り組み PHPの型を使いこなしたい PHPでも近年、静的型付け言語と同じようにメソッドの引数や戻り値、クラスのプロパティなどの型宣言を書くことができるようになってきています。型宣言はPHP5.0から部分的にサポートされていましたが、本格的に使えるようになったのは2015年リリースの7.0あたりからです。 PHP 7.0：スカラー型宣言、戻り値の型宣言 PHP 7.1：nullableな型 PHP 7.4：プロパティの型宣言 P
この記事はPHPStan開発者のOndřej Mirtesによって2022年11月3日にPHPStan Blogに書かれた記事を翻訳したものです。 phpstan.org PHPStan 1.9.0はまさにコミュニティの尽力によるものです。目玉機能はすべて、メンテナーである私(Ondřej)以外の誰かの貢献です。コードを書くのが嫌になったわけではないのですが、私が草むらで謎のバグを追いかけている間にも、ほかの人は新しい機能をより早く実装できるようになります。 私はここのところ緑色の「Merge」ボタンを一日に何度も押しています。私の役割はコードの主要な貢献者から、品質保障(QA)とプロジェクトビジョン1、そして継続的インテグレーション(CI)パイプラインの処理に移行しています。私は最近、貢献者向けのレターContributors update #1 2022でそれを認めました。これはあなた
PHPコメントの書き方（PHPDoc） - Laravel学習帳
みなさんはLaravelを使ってPHPのソースコードを書くとき、どのようにコメントを書くでしょうか？覚書きに程度に使用はしていませんか？ プログラミングにおけるコメントの書き方はとても重要です。 きちんとしたコメントの書き方をすれば、一見複雑な処理でも処理内容がすぐに分かるようになります。 そのため、厳密にコメントを記載することをルールとしている企業もあります。 今回はPHPにおけるコメントの書き方（主にPHPDoc）についてエントリーします。 「コメント」と「コメントアウト」は意味が少し違います。 コメントアウトはソースコードをコメントすることで、プログラムを無効化することを指します。 1. ドキュメントコメント（DocComment）の書き方 PHPでのコメントの書き方には4種類あります。 一行コメント シェバン（shebang） 複数行コメント ドキュメントコメント（DocCommn
phpDocumentor Back to top Previous topic リファレンス Next topic 基本文法 Search Navigation index next | previous | Homepage » Documentation » リファレンス » PHPDoc リファレンス¶ 基本文法 Docブロックって何？ Docブロックにはどんな要素を含むか セクション / Sections Inheritance Inheritance 型の定義 ABNF 単一型 / Atomic (singular) type 複合型 / Multiple types 配列 / Arrays インラインタグ リファレンス @example @internal @inheritdoc @link @see Tag reference @api @author @category
PHPerのための「PHPDoc相談会」【PHP TechCafe イベントレポート】 - RAKUS Developers Blog | ラクス エンジニアブログ
弊社で毎月開催し、PHPエンジニアの間で好評いただいているPHP TechCafe。 2022年7月のイベントでは「PHPDoc」について語り合いました。 弊社のメンバーが事前にまとめてきたPHPDocの情報にしたがって、他の参加者に意見を頂いて語り合いながら学びました。 今回はその内容についてレポートします。 rakus.connpass.com そもそもPHPDocとは何か 活用するポイント 課題 代表的な書き方 基本的なタグ 型の記述 PHPDocに関する質問 最低限書いておきたいコメント 必須 微妙 その他 phpDocumentor使ってますか？ PHPDocの記載がすべて出力されるか phpDocumentorの使いどころは？ PHP TechCafeメンバーの中で出た意見 phpDocumentorで出力されるもの WEB APIに関しての使いどころ PHPDocの記述だけで
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
【PHPDoc】PHPのarray型/Collection型をもっとわかりやすく！
PHPDocベースのassert、list型とPHPStan 1.9.0の新機能 - 超PHPerになろう
PHPDoc リファレンス — phpDocumentor