Merge pull request #279 from cakephp/3.x-docs

update BeforePolicyInterface docs
cakephp · Jan 28, 2024 · 10739f4 · 10739f4
2 parents b0b9b12 + 6ead936
commit 10739f4
Show file tree

Hide file tree

Showing 4 changed files with 14 additions and 6 deletions.
diff --git a/docs/en/policies.rst b/docs/en/policies.rst
@@ -112,11 +112,13 @@ in your policy::
 
     namespace App\Policy;
 
+    use Authorization\IdentityInterface;
     use Authorization\Policy\BeforePolicyInterface;
+    use Authorization\Policy\ResultInterface;
 
     class ArticlesPolicy implements BeforePolicyInterface
     {
-        public function before($user, $resource, $action)
+        public function before(?IdentityInterface $identity, mixed $resource, string $action): ResultInterface|bool|null {
         {
             if ($user->getOriginalData()->is_admin) {
                 return true;

diff --git a/docs/es/policies.rst b/docs/es/policies.rst
@@ -14,7 +14,7 @@ Las clases de la aplicación se 'resuelven' en una clase policy coincidente.
 Consulte la sección :doc:`policy-resolvers` para saber cómo se pueden resolver las policy.
 
 Por lo general, querrá poner sus policy en **src/Policy** y usar el sufijo de clase
-``Policy``. Por ahora crearemos una clase policy para la entidad `Article` en nuestra 
+``Policy``. Por ahora crearemos una clase policy para la entidad `Article` en nuestra
 aplicación. En **src/Policy/ArticlePolicy.php** ponga el siguiente contenido::
 
     <?php
@@ -111,11 +111,13 @@ en su policy::
 
     namespace App\Policy;
 
+    use Authorization\IdentityInterface;
     use Authorization\Policy\BeforePolicyInterface;
+    use Authorization\Policy\ResultInterface;
 
     class ArticlesPolicy implements BeforePolicyInterface
     {
-        public function before($user, $resource, $action)
+        public function before(?IdentityInterface $identity, mixed $resource, string $action): ResultInterface|bool|null {
         {
             if ($user->getOriginalData()->is_admin) {
                 return true;

diff --git a/docs/fr/policies.rst b/docs/fr/policies.rst
@@ -119,11 +119,13 @@ policy doit implémenter ``BeforePolicyInterface``::
 
     namespace App\Policy;
 
+    use Authorization\IdentityInterface;
     use Authorization\Policy\BeforePolicyInterface;
+    use Authorization\Policy\ResultInterface;
 
     class ArticlesPolicy implements BeforePolicyInterface
     {
-        public function before($user, $resource, $action)
+        public function before(?IdentityInterface $identity, mixed $resource, string $action): ResultInterface|bool|null {
         {
             if ($user->getOriginalData()->is_admin) {
                 return true;

diff --git a/docs/ja/policies.rst b/docs/ja/policies.rst
@@ -82,7 +82,7 @@ ORMオブジェクトのポリシーを作成するには ``bake`` コマンド
 ポリシーのスコープ
 ------------------
 
-ポリシーは認可の可否だけでなく、「スコープ」を定義することもできます。 
+ポリシーは認可の可否だけでなく、「スコープ」を定義することもできます。
 スコープメソッドは認可の条件を適用して他のオブジェクトを変更することができます。
 リストの取得を現在のユーザーに限定するときに最適です。::
 
@@ -105,11 +105,13 @@ ORMオブジェクトのポリシーを作成するには ``bake`` コマンド
 
     namespace App\Policy;
 
+    use Authorization\IdentityInterface;
     use Authorization\Policy\BeforePolicyInterface;
+    use Authorization\Policy\ResultInterface;
 
     class ArticlesPolicy implements BeforePolicyInterface
     {
-        public function before($user, $resource, $action)
+        public function before(?IdentityInterface $identity, mixed $resource, string $action): ResultInterface|bool|null {
         {
             if ($user->getOriginalData()->is_admin) {
                 return true;