Merge branch '3.0' into 3.3

en/bake/development.rst

@@ -124,8 +124,8 @@ treat everything else including php tags as plain text.
 
 One way to see/understand how bake templates works, especially when attempting
 to modify bake template files, is to bake a class and compare the template used
-with the pre-processed template file which is left in the application's tmp
-folder.
+with the pre-processed template file which is left in the application's
+**tmp/bake** folder.
 
 So, for example, when baking a shell like so:
 
@@ -158,7 +158,7 @@ looks like this::
 
     }
 
-The pre-processed template file (**tmp/Bake-Shell-shell-ctp.php**), which is the
+The pre-processed template file (**tmp/bake/Bake-Shell-shell-ctp.php**), which is the
 file actually rendered, looks like this::
 
     <CakePHPBakeOpenTagphp

en/console-and-shells/routes-shell.rst

@@ -12,6 +12,7 @@ Getting a List of all Routes
 ----------------------------
 
 ::
+
     bin/cake routes
 
 Testing URL parsing

en/core-libraries/caching.rst

@@ -23,7 +23,7 @@ to implement your own caching systems. The built-in caching engines are:
   atomic operations. However, since disk storage is often quite cheap,
   storing large objects, or elements that are infrequently written
   work well in files.
-* ``ApcCache`` APC cache uses the PHP `APC <http://php.net/apc>`_ extension.
+* ``ApcCache`` APC cache uses the PHP `APCu <http://php.net/apcu>`_ extension.
   This extension uses shared memory on the webserver to store objects.
   This makes it very fast, and able to provide atomic read/write features.
 * ``Wincache`` Wincache uses the `Wincache <http://php.net/wincache>`_

en/core-libraries/hash.rst

@@ -71,20 +71,20 @@ Attribute Matching Types
 |                                | the regular expression inside ``...``.     |
 +--------------------------------+--------------------------------------------+
 
-.. php:staticmethod:: get(array $data, $path, $default = null)
+.. php:staticmethod:: get(array|\ArrayAccess $data, $path, $default = null)
 
     ``get()`` is a simplified version of ``extract()``, it only supports direct
     path expressions. Paths with ``{n}``, ``{s}`` or matchers are not
     supported. Use ``get()`` when you want exactly one value out of an array. If
     a matching path is not found the default value will be returned.
 
-.. php:staticmethod:: extract(array $data, $path)
+.. php:staticmethod:: extract(array|\ArrayAccess $data, $path)
 
     ``Hash::extract()`` supports all expression, and matcher components of
-    :ref:`hash-path-syntax`. You can use extract to retrieve data from arrays,
-    along arbitrary paths quickly without having to loop through the data
-    structures. Instead you use path expressions to qualify which elements you
-    want returned ::
+    :ref:`hash-path-syntax`. You can use extract to retrieve data from arrays
+    or object implementing ``ArrayAccess`` interface, along arbitrary paths
+    quickly without having to loop through the data structures. Instead you
+    use path expressions to qualify which elements you want returned ::
 
         // Common Usage:
         $users = [

en/core-libraries/time.rst

@@ -214,17 +214,22 @@ The default locale in which dates are displayed when using ``nice``
 `intl.default_locale <http://www.php.net/manual/en/intl.configuration.php#ini.intl.default-locale>`_.
 You can, however, modify this default at runtime::
 
-    Time::$defaultLocale = 'es-ES';
+    // The same method exists on Date, FrozenDate, and FrozenTime
+    Time::setDefaultLocale('es-ES');
 
-From now on, dates will be displayed in the Spanish preferred format unless
+From now on, datetimes will be displayed in the Spanish preferred format unless
 a different locale is specified directly in the formatting method.
 
 Likewise, it is possible to alter the default formatting string to be used for
 ``i18nFormat``::
 
+    // The same method exists on Date, FrozenDate and FrozenTime
     Time::setToStringFormat(\IntlDateFormatter::SHORT);
 
-    Time::setToStringFormat([\IntlDateFormatter::FULL, \IntlDateFormatter::SHORT]);
+    Time::setToStringFormat([
+        \IntlDateFormatter::FULL,
+        \IntlDateFormatter::SHORT
+    ]);
 
     Time::setToStringFormat('yyyy-MM-dd HH:mm:ss');
 

en/development/testing.rst

@@ -945,12 +945,17 @@ token mismatches::
         $this->enableSecurityToken();
         $this->post('/posts/add', ['title' => 'Exciting news!']);
     }
+    
+It is also important to enable debug in tests that use tokens to prevent the
+SecurityComponent from thinking the debug token is being used in a non-debug
+environment.
 
 .. versionadded:: 3.1.2
     The ``enableCsrfToken()`` and ``enableSecurityToken()`` methods were added
     in 3.1.2
 
 
+
 Assertion methods
 -----------------
 

en/tutorials-and-examples/bookmarks/intro.rst

@@ -14,6 +14,16 @@ Here's what you'll need:
    that you have ``pdo_mysql`` enabled in PHP.
 #. Basic PHP knowledge.
 
+Before starting you should make sure that you have got an up to date PHP
+version:
+
+.. code-block:: bash
+
+    php -v
+
+You should at least have got installed PHP 5.5.9 (cli) or higher.
+Your webserver's PHP version must also be of 5.5.9 or higher, and should best be
+the same version your command line interface (cli) PHP version is of.
 If you'd like to see the completed application, checkout `cakephp/bookmarker
 <https://github.com/cakephp/bookmarker-tutorial>`__. Let's get started!
 

es/intro/cakephp-folder-structure.rst

@@ -1,15 +1,75 @@
 CakePHP Folder Structure
 ########################
 
-.. note::
-    La documentación no es compatible actualmente con el idioma español en esta página.
+Después de haber descargado y extraido la aplicación CakePHP, estos son los
+archivos y directorios que podrás ver:
 
-    Por favor, siéntase libre de enviarnos un pull request en
-    `Github <https://github.com/cakephp/docs>`_ o utilizar el botón **Improve this Doc** para proponer directamente los cambios.
+- bin
+- config
+- logs
+- plugins
+- src
+- tests
+- tmp
+- vendor
+- webroot
+- .htaccess
+- composer.json
+- index.php
+- README.md
+
+Notarás unos cuantos directorios de primer nivel:
+
+- La carpeta *bin* contiene los ejecutables por consola de Cake.
+- La carpeta *config* contiene los documentos de
+  :doc:`/development/configuration` que utiliza CakePHP. Detalles de la conexión
+  a la Base de Datos, bootstrapping, arhivos de configuración del core y otros,
+  serán almacenados aquí.
+- La carpeta *plugins* es donde se almacenan los :doc:`/plugins` que utiliza tu
+  aplicación.
+- La carpeta de *logs* contiene normalmente tus archivos de log, dependiendo de
+  tu configuración de log.
+- La carpeta *src* será donde tu crearás tu mágia: es donde se almacenarán los
+  archivos de tu aplicación.
+- La carpeta *tests* será donde pondrás los test para tu aplicación.
+- La carpeta *tmp* es donde CakePHP almacenará temporalmente la información. La
+  información actual que almacenará dependerá de cómo se configure CakePHP, pero
+  esta carpeta es normalmente utilizada para almacenar descripciones de modelos
+  y a veces información de sesión.
+- La carpeta *vendor* es donde CakePHP y otras dependencias de la aplicación
+  serán instaladas. Comprométete a **no** editar los archivos de esta carpeta.
+  No podremos ayudarte si modificas el core.
+- El directorio *webroot* es la raíz de los documentos públicos de tu
+  aplicación. Contiene todos los archivos que quieres que sean accesibles
+  públicamente.
+
+Asegúrate de que las carpetas *tmp* y *logs* existen y permiten escritura, en
+caso contrario el rendimiento de tu aplicación se verá gravemente perjudicado.
+En modo debug, CakePHP te avisará si este no es el caso.
+
+
+La carpeta src
+==============
+
+La carpeta *src* de CakePHP es donde tú harás la mayor parte del desarrollo de
+tu aplicación. Observemos más detenidamente dentro de la carpeta *src*.
+
+Console
+    Contiene los comandos de consola y las tareas de consola de tu aplicación.
+    Para más información mirar :doc:`/console-and-shells`.
+Controller
+    Contiene los controladores de tu aplicación y sus componentes.
+Locale
+    Almacena los ficheros de string para la internacionalización.
+Model
+    Contiene las tablas, entidades y funcionamiento de tu aplicación.
+View
+    Las clases de presentación se ubican aquí: cells, helpers y templates.
+Template
+    Los archivos de presentación se almacenan aquí: elementos, páginas de error,
+    layouts, y templates.
 
-    Usted puede hacer referencia a la versión en Inglés en el menú de selección superior
-    para obtener información sobre el tema de esta página.
 
 .. meta::
-    :title lang=es: CakePHP Folder Structure
-    :keywords lang=es: internal libraries,core configuration,model descriptions,external vendors,connection details,folder structure,party libraries,personal commitment,database connection,internationalization,configuration files,folders,application development,readme,lib,configured,logs,config,third party,cakephp
+    :title lang=es: CakePHP Structura de Carpetas
+    :keywords lang=es: librerias internas,configuracion core,descripciones de modelos, vendors externos,detalles de conexión,estructura de carpetas,librerías,compromiso personal,conexión base de datos,internacionalización,archivos de configuración,carpetas,desarrollo de aplicaciones,léeme,lib,configurado,logs,config,third party,cakephp

fr/bake/development.rst

@@ -132,7 +132,7 @@ balises php, comme du texte.
 Une façon de voir/comprendre la façon dont les templates de Bake fonctionne,
 spécialement quand on essaie de modifier les fichiers de template de bake, est
 de créer avec bake une classe et de comparer le template utilisé avec le
-template déjà présent dans le dossier tmp de votre application.
+template déjà présent dans le dossier **tmp/bake** de votre application.
 
 Ainsi, par exemple, pour créer avec bake un shell comme ceci:
 
@@ -167,7 +167,7 @@ ressemble à ceci::
     }
 
 Le fichier template déjà présent (pre-processed)
-(**tmp/Bake-Shell-shell-ctp.php**), qui est le fichier réellement
+(**tmp/bake/Bake-Shell-shell-ctp.php**), qui est le fichier réellement
 rendu, ressemble à ceci::
 
     <CakePHPBakeOpenTagphp

fr/console-and-shells/routes-shell.rst

@@ -12,6 +12,7 @@ Récupérer une Liste de Toutes les Routes
 ----------------------------------------
 
 ::
+
     bin/cake routes
 
 Tester le parsing de l'URL

fr/core-libraries/caching.rst

@@ -28,7 +28,7 @@ votre propre système de mise en cache. Les moteurs de cache intégrés sont:
   grands objets ou des éléments qui sont rarement écrits fonctionne
   bien dans les fichiers.
 * ``ApcCache`` Le cache APC utilise l'extension PHP
-  `APC <http://php.net/apc>`_. Cette extension utilise la mémoire partagée du
+  `APCu <http://php.net/apcu>`_. Cette extension utilise la mémoire partagée du
   serveur Web pour stocker les objets. Cela le rend très rapide, et capable de
   fournir les fonctionnalités atomiques en lecture/écriture.
 * ``Wincache`` Utilise l'extension `Wincache <http://php.net/wincache>`_.

fr/core-libraries/hash.rst

@@ -80,22 +80,23 @@ Les Types d'Attribut Correspondants
 |                                | à l'intérieur de ``...``.                  |
 +--------------------------------+--------------------------------------------+
 
-.. php:staticmethod:: get(array $data, $path, $default = null)
+.. php:staticmethod:: get(array|\ArrayAccess $data, $path, $default = null)
 
     ``get()`` est une version simplifiée de ``extract()``, elle ne supporte
     que les expressions de chemin direct. Les chemins avec ``{n}``, ``{s}``
     ou les matchers ne sont pas supportés. Utilisez ``get()`` quand vous
     voulez exactement une valeur sortie d'un tableau. Si un chemin correspondant
     n'est pas trouvé, la valeur par défaut sera retournée.
 
-.. php:staticmethod:: extract(array $data, $path)
+.. php:staticmethod:: extract(array|\ArrayAccess $data, $path)
 
     ``Hash::extract()`` supporte toutes les expressions, les components
     matcher de la :ref:`hash-path-syntax`. Vous pouvez utiliser l'extract pour
-    récupérer les données à partir des tableaux, le long des chemins
-    arbitraires rapidement sans avoir à parcourir les structures de données.
-    A la place, vous utilisez les expressions de chemin pour qualifier
-    les éléments que vous souhaitez retourner::
+    récupérer les données à partir des tableaux, ou bien un objet implémentant
+    l'interface ``ArrayAccess`` avec des chemins arbitraires rapidement sans
+    avoir à parcourir les structures de données. A la place, vous utilisez les
+    expressions de chemin pour qualifier les éléments que vous souhaitez
+    retourner::
 
         // Utilisation habituelle:
         $users = [

fr/core-libraries/time.rst

@@ -222,18 +222,23 @@ La locale par défaut avec laquelle les dates sont affichées quand vous utilise
 `intl.default_locale <http://www.php.net/manual/en/intl.configuration.php#ini.intl.default-locale>`_.
 Vous pouvez cependant modifier ceci par défaut à la volée::
 
-    Time::$defaultLocale = 'es-ES';
+    // La même méthode existe pour les Date, FrozenDate, et FrozenTime
+    Time::setDefaultLocale('es-ES');
 
-A partir de maintenant, les dates vont s'afficher avec un format de préférence
-Espagnol, à moins qu'une locale différente ne soit spécifiée directement dans
-la méthode de formatage.
+A partir de maintenant, les datetimes vont s'afficher avec un format de
+préférence Espagnol, à moins qu'une locale différente ne soit spécifiée
+directement dans la méthode de formatage.
 
 De même, il est possible de modifier la chaîne de formatage par défaut à
 utiliser pour le format ``i18nFormat``::
 
+    // La même méthode existe pour les Date, FrozenDate, et FrozenTime
     Time::setToStringFormat(\IntlDateFormatter::SHORT);
 
-    Time::setToStringFormat([\IntlDateFormatter::FULL, \IntlDateFormatter::SHORT]);
+    Time::setToStringFormat([
+        \IntlDateFormatter::FULL,
+        \IntlDateFormatter::SHORT
+    ]);
 
     Time::setToStringFormat('yyyy-MM-dd HH:mm:ss');
 

fr/development/testing.rst

@@ -999,10 +999,15 @@ tests ne vont pas être en échec à cause d'un token non présent::
         $this->post('/posts/add', ['title' => 'News excitante!']);
     }
 
+Il est aussi important d'activer debug dans les tests qui utilisent les tokens
+pour éviter que le SecurityComponent pense que le token debug est utilisé dans
+un environnement non-debug.
+
 .. versionadded:: 3.1.2
     Les méthodes ``enableCsrfToken()`` et ``enableSecurityToken()`` ont été
     ajoutées dans la version 3.1.2.
 
+
 Méthodes d'Assertion
 --------------------
 

fr/tutorials-and-examples/bookmarks/intro.rst

@@ -14,6 +14,16 @@ Voici ce dont vous allez avoir besoin:
    MySQL, assurez-vous aussi d'avoir ``pdo_mysql`` activé dans PHP.
 #. Des connaissances de base en PHP.
 
+Avant de commencer, vous devez vous assurer que votre version de PHP est à jour:
+
+.. code-block:: bash
+
+    php -v
+
+Vous devez avoir installé au moins la version 5.5.9 (cli) de PHP ou supérieure.
+La version de PHP de votre serveur web doit aussi être 5.5.9 ou supérieure, et
+doit être préférablement la même version que celle de votre interface en ligne
+de commande (cli).
 Si vous souhaitez voir ce que donne l'application au final, regardez
 `cakephp/bookmarker <https://github.com/cakephp/bookmarker-tutorial>`__. C'est
 parti !