Working with databases (#267)

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Co-authored-by: samdark <47294+samdark@users.noreply.github.com>

Author: samdark

_translations/guide/po/es/README.md.po

@@ -6,7 +6,7 @@
 msgid ""
 msgstr ""
 "Project-Id-Version: PACKAGE VERSION\n"
-"POT-Creation-Date: 2025-09-11 10:15+0500\n"
+"POT-Creation-Date: 2025-11-03 12:48+0000\n"
 "PO-Revision-Date: 2025-09-04 11:19+0500\n"
 "Last-Translator: Automatically generated\n"
 "Language-Team: none\n"

_translations/guide/po/es/databases_db-migrations.md.po

@@ -6,7 +6,7 @@
 msgid ""
 msgstr ""
 "Project-Id-Version: PACKAGE VERSION\n"
-"POT-Creation-Date: 2025-09-11 10:15+0500\n"
+"POT-Creation-Date: 2025-10-22 11:35+0000\n"
 "PO-Revision-Date: 2025-09-11 10:15+0500\n"
 "Last-Translator: Automatically generated\n"
 "Language-Team: none\n"
@@ -42,7 +42,7 @@ msgstr ""
 
 #. type: Plain text
 #: ../../guide/en/glossary.md
-msgid "Asset refers to a resource file. Typically, it contains JavaScript or CSS code but can be any static content accessed via HTTP."
+msgid "Asset refers to a resource file. Typically, it contains JavaScript or CSS code but can be any static content accessed via HTTP.  Read more in [\"Assets\"](views/asset.md)."
 msgstr ""
 
 #. type: Title #
@@ -59,7 +59,7 @@ msgstr ""
 
 #. type: Plain text
 #: ../../guide/en/glossary.md
-msgid "The Configuration may refer either to the process of setting properties of an object or to a configuration file that stores settings for an object, or a class of objects. Read more in [\"Configuration\"](concept/configuration.md)."
+msgid "The Configuration may refer either to the process of setting properties of an object or to a configuration file that stores settings for an object, or a class of objects.  Read more in [\"Configuration\"](concept/configuration.md)."
 msgstr ""
 
 #. type: Title #
@@ -76,7 +76,7 @@ msgstr ""
 
 #. type: Plain text
 #: ../../guide/en/glossary.md
-msgid "Dependency Injection is a programming technique where an object injects a dependent object. [\"DI\"](concept/di-container.md)"
+msgid "Dependency Injection is a programming technique where an object injects a dependent object.  Read more in [\"Dependency injection and container\"](concept/di-container.md)."
 msgstr ""
 
 #. type: Title #
@@ -110,7 +110,7 @@ msgstr ""
 
 #. type: Plain text
 #: ../../guide/en/glossary.md
-msgid "Middleware is a processor in the request processing stack. Given a request, it may either produce a response or do some action and pass processing to the next middleware. Read more in [\"Middleware\"](structure/middleware.md)."
+msgid "Middleware is a processor in the request processing stack. Given a request, it may either produce a response or do some action and pass processing to the next middleware.  Read more in [\"Middleware\"](structure/middleware.md)."
 msgstr ""
 
 #. type: Title ##
@@ -121,7 +121,7 @@ msgstr ""
 
 #. type: Plain text
 #: ../../guide/en/glossary.md
-msgid "The module is a sub-application that groups some code based on a use-case. It's typically used within the main application and may contain URL handlers or console commands."
+msgid "The module is a namespace that groups some code based on a use-case. It's typically used within the main application and may contain any source code, define additional URL handlers or console commands."
 msgstr ""
 
 #. type: Title #
@@ -138,7 +138,7 @@ msgstr ""
 
 #. type: Plain text
 #: ../../guide/en/glossary.md
-msgid "Namespace refers to a [PHP language feature](https://www.php.net/manual/en/language.namespaces.php)."
+msgid "Namespace refers to a [PHP language feature](https://www.php.net/manual/en/language.namespaces.php) to group multiple classes under a certain name."
 msgstr ""
 
 #. type: Title #
@@ -189,7 +189,7 @@ msgstr ""
 
 #. type: Plain text
 #: ../../guide/en/glossary.md
-msgid "A queue is similar to a stack. Queue follows First-In-First-Out methodology."
+msgid "A queue is similar to a stack. Queue follows First-In-First-Out methodology.  Yii has a [yiisoft/queue](https://github.com/yiisoft/queue) package."
 msgstr ""
 
 #. type: Title #
@@ -206,5 +206,5 @@ msgstr ""
 
 #. type: Plain text
 #: ../../guide/en/glossary.md
-msgid "A Vendor is an organization or individual developer providing code in the form of packages. It also may refer to [Composer's `vendor` directory](https://getcomposer.org/doc/)."
+msgid "A Vendor is an organization or individual developer providing code in the form of packages.  It also may refer to [Composer's `vendor` directory](https://getcomposer.org/doc/)."
 msgstr ""

_translations/guide/po/es/glossary.md.po

@@ -6,7 +6,7 @@
 msgid ""
 msgstr ""
 "Project-Id-Version: PACKAGE VERSION\n"
-"POT-Creation-Date: 2025-09-04 11:19+0500\n"
+"POT-Creation-Date: 2025-10-22 11:35+0000\n"
 "PO-Revision-Date: 2025-09-04 11:19+0500\n"
 "Last-Translator: Automatically generated\n"
 "Language-Team: none\n"
@@ -16,147 +16,153 @@ msgstr ""
 "Content-Transfer-Encoding: 8bit\n"
 "Plural-Forms: nplurals=2; plural=(n != 1);\n"
 
+#. type: Title ###
+#: ../../guide/en/README.md ../../guide/en/intro/upgrade-from-v2.md
+#, no-wrap
+msgid "Application structure"
+msgstr ""
+
 #. type: Title #
-#: en/intro/upgrade-from-v2.md
+#: ../../guide/en/intro/upgrade-from-v2.md
 #, no-wrap
 msgid "Upgrading from Version 2.0"
 msgstr ""
 
 #. type: Plain text
-#: en/intro/upgrade-from-v2.md
+#: ../../guide/en/intro/upgrade-from-v2.md
 #, no-wrap
 msgid ""
 "> If you haven't used Yii2, you can skip this section and get directly to \"[getting started](../start/installation.md)\"\n"
 "> section.\n"
 msgstr ""
 
 #. type: Plain text
-#: en/intro/upgrade-from-v2.md
+#: ../../guide/en/intro/upgrade-from-v2.md
 msgid "While sharing some common ideas and values, Yii 3 is conceptually different from Yii 2. There is no easy upgrade path, so first [check maintenance policy and end-of-life dates for Yii 2](https://www.yiiframework.com/release-cycle)  and consider starting new projects on Yii 3 while keeping existing ones on Yii 2."
 msgstr ""
 
 #. type: Title ##
-#: en/intro/upgrade-from-v2.md
+#: ../../guide/en/intro/upgrade-from-v2.md
 #, no-wrap
 msgid "PHP requirements"
 msgstr ""
 
 #. type: Plain text
-#: en/intro/upgrade-from-v2.md
+#: ../../guide/en/intro/upgrade-from-v2.md
 msgid "Yii3 requires PHP 8.2 or above. As a result, there are language features used that weren't used in Yii 2:"
 msgstr ""
 
 #. type: Bullet: '- '
-#: en/intro/upgrade-from-v2.md
+#: ../../guide/en/intro/upgrade-from-v2.md
 msgid "[Type declarations](https://www.php.net/manual/en/functions.arguments.php#functions.arguments.type-declaration)"
 msgstr ""
 
 #. type: Bullet: '- '
-#: en/intro/upgrade-from-v2.md
+#: ../../guide/en/intro/upgrade-from-v2.md
 msgid "[Return type declarations](https://www.php.net/manual/en/functions.returning-values.php#functions.returning-values.type-declaration)"
 msgstr ""
 
 #. type: Bullet: '- '
-#: en/intro/upgrade-from-v2.md
+#: ../../guide/en/intro/upgrade-from-v2.md
 msgid "[Class constant visibility](https://www.php.net/manual/en/language.oop5.constants.php)"
 msgstr ""
 
 #. type: Bullet: '- '
-#: en/intro/upgrade-from-v2.md
+#: ../../guide/en/intro/upgrade-from-v2.md
 msgid "[Named arguments](https://www.php.net/manual/en/functions.arguments.php#functions.named-arguments)"
 msgstr ""
 
 #. type: Bullet: '- '
-#: en/intro/upgrade-from-v2.md
+#: ../../guide/en/intro/upgrade-from-v2.md
 msgid "[Anonymous classes](https://www.php.net/manual/en/language.oop5.anonymous.php)"
 msgstr ""
 
 #. type: Bullet: '- '
-#: en/intro/upgrade-from-v2.md
+#: ../../guide/en/intro/upgrade-from-v2.md
 msgid "[::class](https://www.php.net/manual/en/language.oop5.basic.php#language.oop5.basic.class.class)"
 msgstr ""
 
 #. type: Bullet: '- '
-#: en/intro/upgrade-from-v2.md
+#: ../../guide/en/intro/upgrade-from-v2.md
 msgid "[Generators](https://www.php.net/manual/en/language.generators.php)"
 msgstr ""
 
 #. type: Bullet: '- '
-#: en/intro/upgrade-from-v2.md
+#: ../../guide/en/intro/upgrade-from-v2.md
 msgid "[Variadic functions](https://www.php.net/manual/en/functions.arguments.php#functions.variable-arg-list)"
 msgstr ""
 
 #. type: Bullet: '- '
-#: en/intro/upgrade-from-v2.md
+#: ../../guide/en/intro/upgrade-from-v2.md
 msgid "[Readonly properties](https://www.php.net/manual/en/language.oop5.properties.php#language.oop5.properties.readonly-properties)"
 msgstr ""
 
 #. type: Bullet: '- '
-#: en/intro/upgrade-from-v2.md
+#: ../../guide/en/intro/upgrade-from-v2.md
 msgid "[Readonly classes](https://www.php.net/manual/en/language.oop5.basic.php#language.oop5.basic.class.readonly)"
 msgstr ""
 
 #. type: Bullet: '- '
-#: en/intro/upgrade-from-v2.md
+#: ../../guide/en/intro/upgrade-from-v2.md
 msgid "[Constructor property promotion](https://www.php.net/manual/en/language.oop5.decon.php#language.oop5.decon.constructor.promotion)"
 msgstr ""
 
 #. type: Bullet: '- '
-#: en/intro/upgrade-from-v2.md
+#: ../../guide/en/intro/upgrade-from-v2.md
 msgid "[Attributes](https://www.php.net/manual/en/language.attributes.php)"
 msgstr ""
 
 #. type: Title ##
-#: en/intro/upgrade-from-v2.md
+#: ../../guide/en/intro/upgrade-from-v2.md
 #, no-wrap
 msgid "Preliminary refactoring"
 msgstr ""
 
 #. type: Plain text
-#: en/intro/upgrade-from-v2.md
+#: ../../guide/en/intro/upgrade-from-v2.md
 msgid "It's a good idea to refactor your Yii 2 project before porting it to Yii 3. That would both make porting easier and benefit the project in question while it's not moved to Yii 3 yet."
 msgstr ""
 
 #. type: Title ###
-#: en/intro/upgrade-from-v2.md
+#: ../../guide/en/intro/upgrade-from-v2.md
 #, no-wrap
 msgid "Use DI instead of the service locator"
 msgstr ""
 
 #. type: Plain text
-#: en/intro/upgrade-from-v2.md
+#: ../../guide/en/intro/upgrade-from-v2.md
 #, no-wrap
 msgid ""
 "Since Yii 3 is forcing you to inject dependencies, it's a good idea to prepare and switch from using\n"
 "service locator (`Yii::$app->`) to [DI container](https://www.yiiframework.com/doc/guide/2.0/en/concept-di-container).\n"
 msgstr ""
 
 #. type: Plain text
-#: en/intro/upgrade-from-v2.md
+#: ../../guide/en/intro/upgrade-from-v2.md
 #, no-wrap
 msgid ""
 "If usage of DI container is problematic for whatever reason, consider moving all calls to `Yii::$app->` to controller\n"
 "actions and widgets and passing dependencies manually from a controller to what needs them.\n"
 msgstr ""
 
 #. type: Plain text
-#: en/intro/upgrade-from-v2.md
+#: ../../guide/en/intro/upgrade-from-v2.md
 msgid "See [Dependency injection and container](../concept/di-container.md) for an explanation of the idea."
 msgstr ""
 
 #. type: Title ###
-#: en/intro/upgrade-from-v2.md
+#: ../../guide/en/intro/upgrade-from-v2.md
 #, no-wrap
 msgid "Introduce repositories for getting data"
 msgstr ""
 
 #. type: Plain text
-#: en/intro/upgrade-from-v2.md
+#: ../../guide/en/intro/upgrade-from-v2.md
 msgid "Since Active Record isn't the only way to work with a database in Yii 3, consider introducing repositories that would hide details of getting data and gather them in a single place. You can later redo it:"
 msgstr ""
 
 #. type: Fenced code block (php)
-#: en/intro/upgrade-from-v2.md
+#: ../../guide/en/intro/upgrade-from-v2.md
 #, no-wrap
 msgid ""
 "final readonly class PostRepository\n"
@@ -175,93 +181,88 @@ msgid ""
 msgstr ""
 
 #. type: Title ###
-#: en/intro/upgrade-from-v2.md
+#: ../../guide/en/intro/upgrade-from-v2.md
 #, no-wrap
 msgid "Separate domain layer from infrastructure"
 msgstr ""
 
 #. type: Plain text
-#: en/intro/upgrade-from-v2.md
+#: ../../guide/en/intro/upgrade-from-v2.md
 msgid "In case you have a rich complicated domain, it's a good idea to separate it from infrastructure provided by a framework that's all the business logic has to go to framework-independent classes."
 msgstr ""
 
 #. type: Title ###
-#: en/intro/upgrade-from-v2.md
+#: ../../guide/en/intro/upgrade-from-v2.md
 #, no-wrap
 msgid "Move more into components"
 msgstr ""
 
 #. type: Plain text
-#: en/intro/upgrade-from-v2.md
+#: ../../guide/en/intro/upgrade-from-v2.md
 msgid "Yii 3 services are conceptually similar to Yii 2 components, so it's a good idea to move reusable parts of your application into components."
 msgstr ""
 
 #. type: Title ##
-#: en/intro/upgrade-from-v2.md
+#: ../../guide/en/intro/upgrade-from-v2.md
 #, no-wrap
 msgid "Things to learn"
 msgstr ""
 
 #. type: Title ##
-#: en/intro/upgrade-from-v2.md en/start/prerequisites.md
+#: ../../guide/en/intro/upgrade-from-v2.md
+#: ../../guide/en/start/prerequisites.md
 #, no-wrap
 msgid "Docker"
 msgstr ""
 
 #. type: Plain text
-#: en/intro/upgrade-from-v2.md
+#: ../../guide/en/intro/upgrade-from-v2.md
 msgid "Default application templates are using [Docker](https://www.docker.com/get-started/) to run application.  It's a good idea to learn how to use it and use it for your own projects since it provides a lot of benefits:"
 msgstr ""
 
 #. type: Bullet: '1. '
-#: en/intro/upgrade-from-v2.md
+#: ../../guide/en/intro/upgrade-from-v2.md
 msgid "Exactly the same environment as in production."
 msgstr ""
 
 #. type: Bullet: '2. '
-#: en/intro/upgrade-from-v2.md
+#: ../../guide/en/intro/upgrade-from-v2.md
 msgid "No need to install anything except Docker itself."
 msgstr ""
 
 #. type: Bullet: '3. '
-#: en/intro/upgrade-from-v2.md
+#: ../../guide/en/intro/upgrade-from-v2.md
 msgid "Environment is per application, not per server."
 msgstr ""
 
 #. type: Title ###
-#: en/intro/upgrade-from-v2.md
+#: ../../guide/en/intro/upgrade-from-v2.md
 #, no-wrap
 msgid "Environment variables"
 msgstr ""
 
 #. type: Plain text
-#: en/intro/upgrade-from-v2.md
+#: ../../guide/en/intro/upgrade-from-v2.md
 msgid "Yii3 application templates are using [environment variables](https://en.wikipedia.org/wiki/Environment_variable)  to configure pars of the application. The concept is [very handy for Dockerized applications](https://12factor.net/)  but might be alien to users of Yii 1.1 and Yii 2."
 msgstr ""
 
 #. type: Title ###
-#: en/intro/upgrade-from-v2.md
+#: ../../guide/en/intro/upgrade-from-v2.md
 #, no-wrap
 msgid "Handlers"
 msgstr ""
 
 #. type: Plain text
-#: en/intro/upgrade-from-v2.md
+#: ../../guide/en/intro/upgrade-from-v2.md
 msgid "Unlike Yii2, Yii3 doesn't have controllers per se. Instead, it uses [handlers](../structure/handler.md) which are similar to controllers but different."
 msgstr ""
 
-#. type: Title ###
-#: en/intro/upgrade-from-v2.md
-#, no-wrap
-msgid "Application structure"
-msgstr ""
-
 #. type: Plain text
-#: en/intro/upgrade-from-v2.md
+#: ../../guide/en/intro/upgrade-from-v2.md
 msgid "Suggested Yii3 application structure is different from Yii 2.  It's described in [application structure](../structure/overview.md)."
 msgstr ""
 
 #. type: Plain text
-#: en/intro/upgrade-from-v2.md
+#: ../../guide/en/intro/upgrade-from-v2.md
 msgid "Despite that, Yii3 is flexible, so it's still possible to use a structure similar to Yii 2 with Yii 3."
 msgstr ""