Merge branch '5.x' into 5.next

Author: Corey Taylor

en/orm/behaviors/translate.rst

@@ -35,8 +35,8 @@ fields to be translated. For that we create a shadow table ``articles_translatio
     CREATE TABLE `articles_translations` (
         `id` int(11) NOT NULL,
         `locale` varchar(5) NOT NULL,
-        `title` varchar(255) NOT NULL,
-        `body` text NOT NULL,
+        `title` varchar(255),
+        `body` text,
         PRIMARY KEY (`id`,`locale`)
     );
 

en/orm/database-basics.rst

@@ -488,6 +488,9 @@ CakePHP recommends a few conventions for enums:
 - Enum classnames should follow ``{Entity}{ColumnName}`` style to enable
   detection while running bake and to aid with project consistency.
 - Enum cases should use CamelCase style.
+- Enums should implement the ``Cake\Database\Type\EnumLabelInterface`` to
+  improve compatibility with bake, and ``FormHelper``.
+
 
 .. _adding-custom-database-types:
 

ja/tutorials-and-examples/cms/articles-controller.rst

@@ -32,8 +32,7 @@ CMS チュートリアル - Articles コントローラーの作成
     {
         public function index()
         {
-            $this->loadComponent('Paginator');
-            $articles = $this->Paginator->paginate($this->Articles->find());
+            $articles = $this->paginate($this->Articles);
             $this->set(compact('articles'));
         }
     }

ja/tutorials-and-examples/cms/database.rst

@@ -113,6 +113,8 @@ CakePHP のモデルは ``Table`` と ``Entity`` オブジェクトで構成さ
 
     <?php
     // src/Model/Table/ArticlesTable.php
+    declare(strict_types=1);
+
     namespace App\Model\Table;
 
     use Cake\ORM\Table;
@@ -121,6 +123,7 @@ CakePHP のモデルは ``Table`` と ``Entity`` オブジェクトで構成さ
     {
         public function initialize(array $config) : void
         {
+            parent::initialize($config)
             $this->addBehavior('Timestamp');
         }
     }
@@ -152,9 +155,12 @@ Table オブジェクトを ``ArticlesTable`` と名付けることで、CakePHP
     class Article extends Entity
     {
         protected array $_accessible = [
-            '*' => true,
-            'id' => false,
-            'slug' => false,
+            'title' => true,
+            'body' => true,
+            'published' => true,
+            'created' => true,
+            'modified' => true,
+            'users' => true,
         ];
     }
 

ja/tutorials-and-examples/cms/installation.rst

@@ -42,15 +42,15 @@ cURL がインストールされていたら、次のように実行するのが
 
 .. code-block:: console
 
-    php composer.phar create-project --prefer-dist cakephp/app:4.* cms
+    php composer.phar create-project --prefer-dist cakephp/app:5.* cms
 
 `Composer Windows Installer <https://getcomposer.org/Composer-Setup.exe>`_
 をダウンロードして実行した場合、インストールディレクトリー (例えば、 C:\\wamp\\www\\dev\\cakephp3)
 からターミナルに次の行を入力してください。
 
 .. code-block:: console
 
-    composer self-update && composer create-project --prefer-dist cakephp/app:4.* cms
+    composer self-update && composer create-project --prefer-dist cakephp/app:5.* cms
 
 Composer を使うメリットは、 正しいファイルパーミッションの設定や、 **config/app.php**
 ファイルの作成などのように、自動的に完全なセットアップをしてくれることです。