Remove doctrine annotation reader #203
Merged
Conversation
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Codecov ReportPatch coverage:
Additional details and impacted files@@ Coverage Diff @@
## 2.x #203 +/- ##
===========================================
Coverage 100.00% 100.00%
- Complexity 162 168 +6
===========================================
Files 30 30
Lines 457 470 +13
===========================================
+ Hits 457 470 +13
☔ View full report in Codecov by Sentry. |
koriym
force-pushed
the
support_doctrine_annotation_v2
branch
from
e87032e
to
bf9775d
Compare
koriym
force-pushed
the
support_doctrine_annotation_v2
branch
from
5275585
to
890ce9e
Compare
koriym
changed the title
* Created to avoid "version dependencies" on the original doctrine/annotation v1/v2, psr/log and other cache libraries. * This leader is valid in both development and production environments.
koriym
force-pushed
the
support_doctrine_annotation_v2
branch
from
de2eecd
to
20db177
Compare
koriym
force-pushed
the
support_doctrine_annotation_v2
branch
from
20db177
to
a805754
Compare
| /** @var array<string, array<object>> */ | ||
| private $loadedAnnotations = []; | ||
|
|
||
| /** @var int[] */ | ||
| private $loadedFilemtimes = []; | ||
|
|
||
| public function __construct(Reader $reader, CacheItemPoolInterface $cache, bool $debug = false) | ||
| public function __construct(Reader $reader, Cache $cache) |
There was a problem hiding this comment.
Cache も interface があれば、例えば APCu に変更したいときに APCuCache だけを実装すればOKになるかなと思いましたがどうですかね。。？
There was a problem hiding this comment.
アノテーションリーダーからアトリビュートの過渡期で、より高速を望むなら、
A) rectorなどでアトリビュートにするか または B)オリジナルのキャッシュリーダー PsrCachedReader を使うか
という選択肢があり、ここでB）を選択しなかったのは「他のライブラリに依存するより最小で自己完結的にした方が良い」と考えたからです。ここで新しいインターフェイスを導入するのは"自己完結"に背くような気もして入れてない感じです。いつもは可能な限り汎用品を使って租結合にしてますが、ここは違うところでは？と考えました。どうでしょうか？
There was a problem hiding this comment.
"シナリオ"をパフォーマンスに含めました。
NaokiTsuchiya
approved these changes
Sep 11, 2023
This was referenced Sep 11, 2023
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
ReflectionClassandReflectionMethodIn order to minimize version dependencies on other libraries such as doctirine v1/v2, psr/cache v1/v2/v3, and other symfony caches, and to enable efficient annotation usage that is useful both in development and in production, we decided that it would be better to keep our own (extremely) minimal cache reader for reading annotations Aop decided that it would be better to maintain its own extremely minimal cache reader for reading annotations, instead of using a generic cache library as before.
Aop/Ray.Di applications can use the following methods for fast annotation/attribute usage instead of using the doctrine/annotation reader as before.
doctirine v1/v2, psr/cache v1/v2/v3, 他symfony cacheなどの他のライブラリのバージョンの依存を最小化し、開発時でもプロダクションでも有用な効率的なアノテーション利用を可能にするために、アノテーションの読み込みにこれまでのように汎用のキャッシュライブラリを利用するのではなく、独自の極端に最小化したキャッシュリーダーを保持するのが良いと判断しました。
。Ray.Aop/Ray.Diを使ったアプリケーションはこれまでの様にdoctrine/annotationリーダーを使うのではなく以下のメソッドで高速にアノテーション/アトリビュート双方が利用できます。
背景
php8でdoctrine/annotationの代替となるPHP8ネイティブのアトリビュートの機能がリリースされ、これからannotationの重要度は低下していく前提があります。また他にも他のライブラリの依存対応の問題もあります。
https://packagist.org/packages/psr/cache
シナリオ
annotationの理由が必須な場合で開発時
ファイルの時間をベースにしたキャッシュでキャッシュ削除などのメンテナンスが不要です。
annotationの理由が必須な場合でプロダクション時
何もしなくてもPHPファイルキャッシュが機能しますが、さらに最適化が必要な場合はブートストラップで以下のコードのように最適化したアノテーションリーダーをセットします。
annotationの理由が不要な場合
rectorなどで既存のアノテーションを全てアトリビュートに変更した場合は、以下のコードのように最適化したアノテーションリーダーをセットします。
いずれの場合も広報互換性は保たれ、アノテーションを取り除いた後でもパフォーマンスインパクトは最小に抑えられると考えられます。