この記事はPHPStan開発者のOndřej Mirtesによって2019年12月2日に書かれた記事を翻訳したものです。記事の末尾には訳者(@tadsan)の観点によるPhan, Psalm, PhpStormとの互換性についての情報も記述しています。 medium.com 2年前、私(Ondřej Mirtes)はユニオン型と交差型についての衝撃的な記事を書きました。PHPコミュニティがこれらの概念に馴染むのを手助けし、PhpStormでの交差型サポートにつながりました。 ユニオン型と交差型の違いは開発者が認識すべき静的解析に役立つ重要な概念なので、私はその記事を書きました。今回は同様に、PHPStan 0.12で導入されたジェネリクスについて、それが何であるかを説明したいと思います。 無限のシグネチャ 関数宣言するとき、我々は関数に付属する単一のシグネチャを書いていました。ほかの選択肢
はじめに こんにちは。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の記述だけで
本稿はBASE Advent Calendar 2019 🎅🎄の14日目です！ こんにちは、Product Divisionの金城(@o0h_)と申します。 10月にBASEに入社しまして、ブログ投稿は本稿が初となります。よろしくおねがいします。 さて、早速掲題の件に入らせていただきます。 PSR, PHP-FIG 「PSRはPHP-FIGが策定し運用する一連の規格であり、その19号はPHPDoc Tagsについての決め事」です。 PSRには色々なレイヤーのルールが ─時には「本来の主旨を超えている」という批判をもさえ巻き起こしながら─ 策定されています。1 PHP-FIGは、元々はオートローディング活用のための取り組み2を契機として作られた団体です3。つまり、元来から「PHPの書き方」に強い関心を持っていたとも言えます。 PSRの「0番目がAutoloading Standard」と
Development, Translation, daily life, thoughts, and so on. 自分は PHP マニュアルのコミット権限を持っているが、2013年に chm のビルドインフラを引き継いだ時 以来、その権限をまともに行使したことはあまりなかった。実際 自分が対応した chm のビルドインフラのバグ報告は4回 しかないし、phpdoc 本体のコミット数も 2013年 - 2018年までの間を数えてみると 10 回あるかないかだ。 今年になり、PHPマニュアル自体があまりメンテナンスされてないっぽいな、という感覚になった。なぜかというと、高木さんや吉田さんなど、これまでよくコミットログで見かけた人たちの作業ログを見かけなくなったからである。 それでも見渡すと、日本語ロケールで最新の更新を維持しているのは全体の6割であり、少し手を加えれば最新に更新できるものを
PHPDocの書き方からドキュメントを自動生成する方法まで紹介！
クラスやメソッドの処理内容を把握しやすくなるコード補完やエラーチェックを行ってくれるPHPStanのような静的解析ツールの精度向上に貢献できるドキュメントを自動生成できる
WordPressはコメントに厳しい。PSRはまだ決まっていない。 PHPのコーディング規約は一般的にPSRを使います。PSRはPHPで開発しているたくさんのプロジェクトが集まってコーディングの共通化を図る団体で、スタンダードなPHPコーディング規約と言っても過言じゃありません。 PSRはかなり早い段階でphpDoc、コメントの規約も用意していたんですが長年ドラフトのまま。一向に公開される気配がない。 PSR (PHP Standards Recommendations) https://www.php-fig.org/psr/ PHP標準勧告。PHPコーディングの標準化を目指す活動のこと。PHP-FIGが策定している。 PHP-FIG (PHP Framework Interop Group) http://www.php-fig.org/ PHPフレームワーク相互運用グループ。PHPプ
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
PHPDocを使ったPHPのジェネリクス - 超PHPerになろう
【PHPDoc】PHPのarray型/Collection型をもっとわかりやすく！
PHPDocベースのassert、list型とPHPStan 1.9.0の新機能 - 超PHPerになろう
PHPDoc リファレンス — phpDocumentor
PSR-19: PHPDoc tagsを予習してみよう - BASEプロダクトチームブログ
phpdoc メンテナンス業を少し強化する気になった - mumumu の日記
WordPress, phpcsが出すコメント（phpDoc）のエラーを直す。