Update manual to latest version of Duckbrain.
This commit is contained in:
parent
32d05121f0
commit
5d4b03b226
@ -3,7 +3,7 @@
|
|||||||
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
|
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
|
||||||
<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
|
<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
|
||||||
<head>
|
<head>
|
||||||
<!-- 2024-05-13 lun 02:02 -->
|
<!-- 2024-05-14 mar 02:58 -->
|
||||||
<meta http-equiv="Content-Type" content="text/html;charset=utf-8" />
|
<meta http-equiv="Content-Type" content="text/html;charset=utf-8" />
|
||||||
<meta name="viewport" content="width=device-width, initial-scale=1" />
|
<meta name="viewport" content="width=device-width, initial-scale=1" />
|
||||||
<title>Duckbrain - Manual de inicio</title>
|
<title>Duckbrain - Manual de inicio</title>
|
||||||
@ -219,57 +219,57 @@ $(function() { $('.note').before("<p class='admonition-title note'>Note</p>")
|
|||||||
<h2>Table of Contents</h2>
|
<h2>Table of Contents</h2>
|
||||||
<div id="text-table-of-contents" role="doc-toc">
|
<div id="text-table-of-contents" role="doc-toc">
|
||||||
<ul>
|
<ul>
|
||||||
<li><a href="#org0c680b9">1. Introducción</a>
|
<li><a href="#org9a7d226">1. Introducción</a>
|
||||||
<ul>
|
<ul>
|
||||||
<li><a href="#orga543768">1.1. Estructura de archivos de Duckbrain</a>
|
<li><a href="#org5a4ba0a">1.1. Estructura de archivos de Duckbrain</a>
|
||||||
<ul>
|
<ul>
|
||||||
<li><a href="#org515f3c2">1.1.1. Carpeta src</a></li>
|
<li><a href="#org4ea86b4">1.1.1. Carpeta src</a></li>
|
||||||
<li><a href="#org6d41d6c">1.1.2. Carpetas: Controllers, Libs, Models, Middlewares, Views y Routers</a></li>
|
<li><a href="#orgb1fa808">1.1.2. Carpetas: Controllers, Libs, Models, Middlewares, Views y Routers</a></li>
|
||||||
<li><a href="#orgbaf73d6">1.1.3. Los archivos en la raíz</a></li>
|
<li><a href="#orgc87d01b">1.1.3. Los archivos en la raíz</a></li>
|
||||||
<li><a href="#org0579e36">1.1.4. Los archivos en la carpeta Libs</a></li>
|
<li><a href="#orga7d97ce">1.1.4. Los archivos en la carpeta Libs</a></li>
|
||||||
</ul>
|
</ul>
|
||||||
</li>
|
</li>
|
||||||
<li><a href="#orgc3629e2">1.2. Comprendiendo el arranque del sistema</a></li>
|
<li><a href="#orgfec9624">1.2. Comprendiendo el arranque del sistema</a></li>
|
||||||
<li><a href="#orgb6ac824">1.3. Extra: Namespaces</a></li>
|
<li><a href="#org2c6b3ec">1.3. Extra: Namespaces</a></li>
|
||||||
</ul>
|
</ul>
|
||||||
</li>
|
</li>
|
||||||
<li><a href="#orge8f976b">2. Primeros pasos</a>
|
<li><a href="#org2ac527f">2. Primeros pasos</a>
|
||||||
<ul>
|
<ul>
|
||||||
<li><a href="#org5030d65">2.1. Usando un Webserver para el desarrollo</a></li>
|
<li><a href="#org40c4a21">2.1. Usando un Webserver para el desarrollo</a></li>
|
||||||
<li><a href="#orgaf9e60a">2.2. Hola mundo</a>
|
<li><a href="#org405d525">2.2. Hola mundo</a>
|
||||||
<ul>
|
<ul>
|
||||||
<li><a href="#org1b78df9">2.2.1. Explicación del código del hola mundo</a></li>
|
<li><a href="#org96ab6d3">2.2.1. Explicación del código del hola mundo</a></li>
|
||||||
</ul>
|
</ul>
|
||||||
</li>
|
</li>
|
||||||
</ul>
|
</ul>
|
||||||
</li>
|
</li>
|
||||||
<li><a href="#org3d0bbaa">3. Mi primera aplicación</a>
|
<li><a href="#org9c2dbee">3. Mi primera aplicación</a>
|
||||||
<ul>
|
<ul>
|
||||||
<li><a href="#org4632ad9">3.1. Definición del proyecto</a></li>
|
<li><a href="#org98d72c4">3.1. Definición del proyecto</a></li>
|
||||||
<li><a href="#org6399f35">3.2. Base de datos</a>
|
<li><a href="#orga494037">3.2. Base de datos</a>
|
||||||
<ul>
|
<ul>
|
||||||
<li><a href="#org53faac3">3.2.1. Configuración de Duckbrain para la base de datos</a></li>
|
<li><a href="#org7401d20">3.2.1. Configuración de Duckbrain para la base de datos</a></li>
|
||||||
</ul>
|
</ul>
|
||||||
</li>
|
</li>
|
||||||
<li><a href="#org6650743">3.3. Modelos</a></li>
|
<li><a href="#orgf4acd86">3.3. Modelos</a></li>
|
||||||
<li><a href="#org091dca6">3.4. Creando vistas</a></li>
|
<li><a href="#org3f20aab">3.4. Creando vistas</a></li>
|
||||||
<li><a href="#org45e7d2c">3.5. Mostrando el formulario</a>
|
<li><a href="#org95443fb">3.5. Mostrando el formulario</a>
|
||||||
<ul>
|
<ul>
|
||||||
<li><a href="#org03756c5">3.5.1. Extra: Explicación del tipo callable</a></li>
|
<li><a href="#org83a2991">3.5.1. Extra: Explicación del tipo callable</a></li>
|
||||||
</ul>
|
</ul>
|
||||||
</li>
|
</li>
|
||||||
<li><a href="#org1704573">3.6. Creando la nota encriptada</a></li>
|
<li><a href="#org7f6f95f">3.6. Creando la nota encriptada</a></li>
|
||||||
<li><a href="#orgc2600c6">3.7. Recta final: Desencriptando y mostrando las notas</a></li>
|
<li><a href="#org9ec9013">3.7. Recta final: Desencriptando y mostrando las notas</a></li>
|
||||||
<li><a href="#orgb6a2dc7">3.8. Repositorio</a></li>
|
<li><a href="#orgb6ce768">3.8. Repositorio</a></li>
|
||||||
</ul>
|
</ul>
|
||||||
</li>
|
</li>
|
||||||
<li><a href="#org792cd68">4. Contacto</a></li>
|
<li><a href="#org6070584">4. Contacto</a></li>
|
||||||
</ul>
|
</ul>
|
||||||
</div>
|
</div>
|
||||||
</div>
|
</div>
|
||||||
|
|
||||||
<div id="outline-container-org0c680b9" class="outline-2">
|
<div id="outline-container-org9a7d226" class="outline-2">
|
||||||
<h2 id="org0c680b9"><span class="section-number-2">1.</span> Introducción</h2>
|
<h2 id="org9a7d226"><span class="section-number-2">1.</span> Introducción</h2>
|
||||||
<div class="outline-text-2" id="text-1">
|
<div class="outline-text-2" id="text-1">
|
||||||
<p>
|
<p>
|
||||||
<a href="https://git.kj2.me/kj/duckbrain">Duckbrain</a> es un conjunto de librerías creadas especialmente pensando en hacer algo simple, que cualquiera pueda deshacer y rearmar fácilmente. Gracias a esa versatilidad, puedes usarlo cualquier proyecto, peo por ello debes tener en cuenta que mientras más grande sea el proyecto, mayor será el nivel de ingeniería que se requerirá de tu parte para acondicionar esta herramienta a los requerimientos.
|
<a href="https://git.kj2.me/kj/duckbrain">Duckbrain</a> es un conjunto de librerías creadas especialmente pensando en hacer algo simple, que cualquiera pueda deshacer y rearmar fácilmente. Gracias a esa versatilidad, puedes usarlo cualquier proyecto, peo por ello debes tener en cuenta que mientras más grande sea el proyecto, mayor será el nivel de ingeniería que se requerirá de tu parte para acondicionar esta herramienta a los requerimientos.
|
||||||
@ -284,8 +284,8 @@ Ducho eso, vamos a comenzar…
|
|||||||
</p>
|
</p>
|
||||||
</div>
|
</div>
|
||||||
|
|
||||||
<div id="outline-container-orga543768" class="outline-3">
|
<div id="outline-container-org5a4ba0a" class="outline-3">
|
||||||
<h3 id="orga543768"><span class="section-number-3">1.1.</span> Estructura de archivos de Duckbrain</h3>
|
<h3 id="org5a4ba0a"><span class="section-number-3">1.1.</span> Estructura de archivos de Duckbrain</h3>
|
||||||
<div class="outline-text-3" id="text-1-1">
|
<div class="outline-text-3" id="text-1-1">
|
||||||
<p>
|
<p>
|
||||||
Al entrar a la carpeta de Duckbrain encontraras esta estructura de archivos (ignoramos el readme.org porque no es necesario).
|
Al entrar a la carpeta de Duckbrain encontraras esta estructura de archivos (ignoramos el readme.org porque no es necesario).
|
||||||
@ -318,8 +318,8 @@ Primero veamos las carpetas y luego los archivos:
|
|||||||
</p>
|
</p>
|
||||||
</div>
|
</div>
|
||||||
|
|
||||||
<div id="outline-container-org515f3c2" class="outline-4">
|
<div id="outline-container-org4ea86b4" class="outline-4">
|
||||||
<h4 id="org515f3c2"><span class="section-number-4">1.1.1.</span> Carpeta src</h4>
|
<h4 id="org4ea86b4"><span class="section-number-4">1.1.1.</span> Carpeta src</h4>
|
||||||
<div class="outline-text-4" id="text-1-1-1">
|
<div class="outline-text-4" id="text-1-1-1">
|
||||||
<p>
|
<p>
|
||||||
En esta carpeta se encuentra todo el código PHP.
|
En esta carpeta se encuentra todo el código PHP.
|
||||||
@ -331,8 +331,8 @@ Como todo en <a href="https://git.kj2.me/kj/duckbrain">Duckbrain</a>, esta ruta
|
|||||||
</div>
|
</div>
|
||||||
</div>
|
</div>
|
||||||
|
|
||||||
<div id="outline-container-org6d41d6c" class="outline-4">
|
<div id="outline-container-orgb1fa808" class="outline-4">
|
||||||
<h4 id="org6d41d6c"><span class="section-number-4">1.1.2.</span> Carpetas: Controllers, Libs, Models, Middlewares, Views y Routers</h4>
|
<h4 id="orgb1fa808"><span class="section-number-4">1.1.2.</span> Carpetas: Controllers, Libs, Models, Middlewares, Views y Routers</h4>
|
||||||
<div class="outline-text-4" id="text-1-1-2">
|
<div class="outline-text-4" id="text-1-1-2">
|
||||||
<p>
|
<p>
|
||||||
Si sabes de estructuras de diseño, el nombre de estas carpetas ya te debe quedar claro qué va en cada una de ellas, puesto que en el nombre de la carpeta dice lo que va a ir dentro.
|
Si sabes de estructuras de diseño, el nombre de estas carpetas ya te debe quedar claro qué va en cada una de ellas, puesto que en el nombre de la carpeta dice lo que va a ir dentro.
|
||||||
@ -343,7 +343,7 @@ Si no sabes que es un Model, un Middleware, Controller, etc. entonces requieres
|
|||||||
</p>
|
</p>
|
||||||
|
|
||||||
<p>
|
<p>
|
||||||
Al igual que con la carpeta <code>src</code>, todo lo puedes cambiar y colocar otra estructura de carpetas y las únicas que requerirían algún tipo de edición de archivos serían las carpetas <code>Views</code> y <code>Router</code> que se editarían en el archivo <code>src/Libs/View.php</code> y el archivo <code>index.php</code> respectivamente. Las demás carpetas las puedes borrar cuando quieras y usar otra estructura, pero por lo pronto no lo hagas al menos hasta que hayas pasado la sección <a href="#org3d0bbaa">3</a> que es cuando ya habrías leído y, con algo de suerte y pericia, asimilado los conocimientos necesarios para hacer lo que te de la gana con este ser de librería al punto de que ya le podrás colocar las tuyas propias, le borrarás alguna de las que viene por defecto porque no la necesites o incluso crees una versión extendida de las que viene por defecto para poder añadirle alguna mejora que necesites.
|
Al igual que con la carpeta <code>src</code>, todo lo puedes cambiar y colocar otra estructura de carpetas y las únicas que requerirían algún tipo de edición de archivos serían las carpetas <code>Views</code> y <code>Router</code> que se editarían en el archivo <code>src/Libs/View.php</code> y el archivo <code>index.php</code> respectivamente. Las demás carpetas las puedes borrar cuando quieras y usar otra estructura, pero por lo pronto no lo hagas al menos hasta que hayas pasado la sección <a href="#org9c2dbee">3</a> que es cuando ya habrías leído y, con algo de suerte y pericia, asimilado los conocimientos necesarios para hacer lo que te de la gana con este ser de librería al punto de que ya le podrás colocar las tuyas propias, le borrarás alguna de las que viene por defecto porque no la necesites o incluso crees una versión extendida de las que viene por defecto para poder añadirle alguna mejora que necesites.
|
||||||
</p>
|
</p>
|
||||||
|
|
||||||
<p>
|
<p>
|
||||||
@ -356,8 +356,8 @@ Para el resto de mortales y gente con menos arrogancia, pueden seguir un ratito
|
|||||||
</div>
|
</div>
|
||||||
</div>
|
</div>
|
||||||
|
|
||||||
<div id="outline-container-orgbaf73d6" class="outline-4">
|
<div id="outline-container-orgc87d01b" class="outline-4">
|
||||||
<h4 id="orgbaf73d6"><span class="section-number-4">1.1.3.</span> Los archivos en la raíz</h4>
|
<h4 id="orgc87d01b"><span class="section-number-4">1.1.3.</span> Los archivos en la raíz</h4>
|
||||||
<div class="outline-text-4" id="text-1-1-3">
|
<div class="outline-text-4" id="text-1-1-3">
|
||||||
<p>
|
<p>
|
||||||
El <code>.htaccess</code> es un archivo que te será útil si usas apache o algún otro servidor web que use estos archivos y lo que lleva es una configuración especial para que funcionen las <b>rutas virtuales</b>, o sea, para que podamos crear una ruta tipo <code>mitsitio.com/mi-ruta-virtual/</code> y podamos decir que allí muestre un mensaje de <code>Hola mundo</code>, a pesar de que la carpeta <code>mi-ruta-virtual</code> no exista, ni haya dentro ningún archivo index que tenga el texto <code>Hola mundo</code>. Si esta aún no lo entendiste, no exasperes que ya lo vas a entender en un momento y ahí podrás volver a repasar esta parte.
|
El <code>.htaccess</code> es un archivo que te será útil si usas apache o algún otro servidor web que use estos archivos y lo que lleva es una configuración especial para que funcionen las <b>rutas virtuales</b>, o sea, para que podamos crear una ruta tipo <code>mitsitio.com/mi-ruta-virtual/</code> y podamos decir que allí muestre un mensaje de <code>Hola mundo</code>, a pesar de que la carpeta <code>mi-ruta-virtual</code> no exista, ni haya dentro ningún archivo index que tenga el texto <code>Hola mundo</code>. Si esta aún no lo entendiste, no exasperes que ya lo vas a entender en un momento y ahí podrás volver a repasar esta parte.
|
||||||
@ -384,8 +384,8 @@ El archivo <code>config.php</code>, como su nombre indica, es el archivo para co
|
|||||||
</div>
|
</div>
|
||||||
</div>
|
</div>
|
||||||
|
|
||||||
<div id="outline-container-org0579e36" class="outline-4">
|
<div id="outline-container-orga7d97ce" class="outline-4">
|
||||||
<h4 id="org0579e36"><span class="section-number-4">1.1.4.</span> Los archivos en la carpeta Libs</h4>
|
<h4 id="orga7d97ce"><span class="section-number-4">1.1.4.</span> Los archivos en la carpeta Libs</h4>
|
||||||
<div class="outline-text-4" id="text-1-1-4">
|
<div class="outline-text-4" id="text-1-1-4">
|
||||||
<p>
|
<p>
|
||||||
Son básicamente librerías, cada una tiene como nombre lo que hace, no tiene mucho misterio y al igual que antes con las carpetas, si sabes algo de diseño, con leer el nombre de las mismas te debería bastar para saber lo que hacen. Si no lo entiendes, sigue leyendo el manual que hablaremos de casi todas poco a poco.
|
Son básicamente librerías, cada una tiene como nombre lo que hace, no tiene mucho misterio y al igual que antes con las carpetas, si sabes algo de diseño, con leer el nombre de las mismas te debería bastar para saber lo que hacen. Si no lo entiendes, sigue leyendo el manual que hablaremos de casi todas poco a poco.
|
||||||
@ -394,8 +394,8 @@ Son básicamente librerías, cada una tiene como nombre lo que hace, no tiene mu
|
|||||||
</div>
|
</div>
|
||||||
</div>
|
</div>
|
||||||
|
|
||||||
<div id="outline-container-orgc3629e2" class="outline-3">
|
<div id="outline-container-orgfec9624" class="outline-3">
|
||||||
<h3 id="orgc3629e2"><span class="section-number-3">1.2.</span> Comprendiendo el arranque del sistema</h3>
|
<h3 id="orgfec9624"><span class="section-number-3">1.2.</span> Comprendiendo el arranque del sistema</h3>
|
||||||
<div class="outline-text-3" id="text-1-2">
|
<div class="outline-text-3" id="text-1-2">
|
||||||
<p>
|
<p>
|
||||||
Como la intención de este manual es que comprendas <a href="https://git.kj2.me/kj/duckbrain">Duckbrain</a> y no solo seas un robot que copia y pega de la documentación, vamos a calentar comprendiendo el código que lo arranca.
|
Como la intención de este manual es que comprendas <a href="https://git.kj2.me/kj/duckbrain">Duckbrain</a> y no solo seas un robot que copia y pega de la documentación, vamos a calentar comprendiendo el código que lo arranca.
|
||||||
@ -410,7 +410,7 @@ Supongamos que entramos en la ruta <code>/hola</code> (o sea, <code>misitio.com/
|
|||||||
</p>
|
</p>
|
||||||
|
|
||||||
<p>
|
<p>
|
||||||
Primero intenta comprobar si el fichero "hola" existe en la ruta a la que se desea acceder, si no es el caso prueba si existe una carpeta "hola" y si tampoco sucede eso, reenvía todo a <code>index.php</code> y le pide que él se encargue de ahí en adelante. Si llega hasta la tercera opción decimos que es una <b>ruta virtual</b> (lo que mencionamos en <a href="#orgbaf73d6">Los archivos en la raiz</a>), porque devolveremos algo desde el PHP simulando un archivo o una carpeta, a pesar de que esa ruta realmente no existe ni como fichero ni como carpeta.
|
Primero intenta comprobar si el fichero "hola" existe en la ruta a la que se desea acceder, si no es el caso prueba si existe una carpeta "hola" y si tampoco sucede eso, reenvía todo a <code>index.php</code> y le pide que él se encargue de ahí en adelante. Si llega hasta la tercera opción decimos que es una <b>ruta virtual</b> (lo que mencionamos en <a href="#orgc87d01b">Los archivos en la raiz</a>), porque devolveremos algo desde el PHP simulando un archivo o una carpeta, a pesar de que esa ruta realmente no existe ni como fichero ni como carpeta.
|
||||||
</p>
|
</p>
|
||||||
|
|
||||||
<p>
|
<p>
|
||||||
@ -423,29 +423,17 @@ Ahora veamos que hace <code>index.php</code>, en la primera línea nos dice esto
|
|||||||
</div>
|
</div>
|
||||||
|
|
||||||
<p>
|
<p>
|
||||||
Aquí carga el archivo <code>config.php</code>, o sea, carga la configuración. Para esta parte del manual, solo nos interesa la última línea ya que todo lo demás en realidad no está configurando nada aún. Lo que dice la línea es esto:
|
Aquí carga el archivo <code>config.php</code>, o sea, carga la configuración. Para esta parte del manual, solo nos interesa las 2 últimas líneas ya que todo lo demás en realidad no está configurando nada aún. Lo que dice las líneas es esto:
|
||||||
</p>
|
</p>
|
||||||
|
|
||||||
<div class="org-src-container">
|
<div class="org-src-container">
|
||||||
<pre class="src src-php">define(<span style="color: #8b2252;">'ROOT_DIR'</span>, <span style="color: #483d8b;">__DIR__</span>);
|
<pre class="src src-php">define(<span style="color: #8b2252;">'ROOT_DIR'</span>, <span style="color: #483d8b;">__DIR__</span>);
|
||||||
|
define(<span style="color: #8b2252;">'ROOT_CORE'</span>, <span style="color: #008b8b;">ROOT_DIR</span>.<span style="color: #8b2252;">'/src'</span>);
|
||||||
</pre>
|
</pre>
|
||||||
</div>
|
</div>
|
||||||
|
|
||||||
<p>
|
<p>
|
||||||
Solo está definiendo una constante <code>ROOT_DIR</code> que contiene como valor el directorio en donde está el archivo <code>config.php</code>, que también sería la raíz de <a href="https://git.kj2.me/kj/duckbrain">Duckbrain</a>.
|
Se está definiendo una constante <code>ROOT_DIR</code> que contiene como valor el directorio en donde está el archivo <code>config.php</code>, que también sería la raíz de <a href="https://git.kj2.me/kj/duckbrain">Duckbrain</a>. La siguiente línea también es la definición de una constante: <code>ROOT_CORE</code> lo que hace es tener la ruta de la carpeta <code>src</code>. Hasta aquí acabamos con la definición de constantes, ahora el bloque que viene es donde se poner lo bueno:
|
||||||
</p>
|
|
||||||
|
|
||||||
<p>
|
|
||||||
La siguiente línea también es la definición de una constante:
|
|
||||||
</p>
|
|
||||||
|
|
||||||
<div class="org-src-container">
|
|
||||||
<pre class="src src-php">define(<span style="color: #8b2252;">'ROOT_CORE'</span>, <span style="color: #008b8b;">ROOT_DIR</span>.<span style="color: #8b2252;">'/src'</span>);
|
|
||||||
</pre>
|
|
||||||
</div>
|
|
||||||
|
|
||||||
<p>
|
|
||||||
Esta constante <code>ROOT_CORE</code> lo que hace es tener la ruta de src. Hasta aquí acabamos con la definición de constantes, ahora el bloque que viene es donde se poner lo bueno:
|
|
||||||
</p>
|
</p>
|
||||||
|
|
||||||
<div class="org-src-container">
|
<div class="org-src-container">
|
||||||
@ -499,8 +487,8 @@ Nótese que lo que ha hecho el autoloader es convertir los backslashes o barras
|
|||||||
</div>
|
</div>
|
||||||
</div>
|
</div>
|
||||||
|
|
||||||
<div id="outline-container-orgb6ac824" class="outline-3">
|
<div id="outline-container-org2c6b3ec" class="outline-3">
|
||||||
<h3 id="orgb6ac824"><span class="section-number-3">1.3.</span> Extra: Namespaces</h3>
|
<h3 id="org2c6b3ec"><span class="section-number-3">1.3.</span> Extra: Namespaces</h3>
|
||||||
<div class="outline-text-3" id="text-1-3">
|
<div class="outline-text-3" id="text-1-3">
|
||||||
<p>
|
<p>
|
||||||
Si eres nuevo en esto puede que no sepas lo que es un namespace, pero si también te dio curiosidad el que la una clase tenga <code>\</code> (backslash) en su nombre, entonces tienes futuro en este campo y como no quiero que te vayas de este manual, voy a explicarte rápidamente de donde viene ese backslash.
|
Si eres nuevo en esto puede que no sepas lo que es un namespace, pero si también te dio curiosidad el que la una clase tenga <code>\</code> (backslash) en su nombre, entonces tienes futuro en este campo y como no quiero que te vayas de este manual, voy a explicarte rápidamente de donde viene ese backslash.
|
||||||
@ -530,16 +518,16 @@ Puede que ahora mismo no notes la utilidad de esto, pero es algo muy útil realm
|
|||||||
</div>
|
</div>
|
||||||
</div>
|
</div>
|
||||||
|
|
||||||
<div id="outline-container-orge8f976b" class="outline-2">
|
<div id="outline-container-org2ac527f" class="outline-2">
|
||||||
<h2 id="orge8f976b"><span class="section-number-2">2.</span> Primeros pasos</h2>
|
<h2 id="org2ac527f"><span class="section-number-2">2.</span> Primeros pasos</h2>
|
||||||
<div class="outline-text-2" id="text-2">
|
<div class="outline-text-2" id="text-2">
|
||||||
<p>
|
<p>
|
||||||
Antes de ponernos a programar vamos a asegurarnos de estar en la misma pagina preparando nuestro entorno de trabajo y haciendo el usual Hola mundo.
|
Antes de ponernos a programar vamos a asegurarnos de estar en la misma pagina preparando nuestro entorno de trabajo y haciendo el usual Hola mundo.
|
||||||
</p>
|
</p>
|
||||||
</div>
|
</div>
|
||||||
|
|
||||||
<div id="outline-container-org5030d65" class="outline-3">
|
<div id="outline-container-org40c4a21" class="outline-3">
|
||||||
<h3 id="org5030d65"><span class="section-number-3">2.1.</span> Usando un Webserver para el desarrollo</h3>
|
<h3 id="org40c4a21"><span class="section-number-3">2.1.</span> Usando un Webserver para el desarrollo</h3>
|
||||||
<div class="outline-text-3" id="text-2-1">
|
<div class="outline-text-3" id="text-2-1">
|
||||||
<p>
|
<p>
|
||||||
Desde luego esta la carpeta con <a href="https://git.kj2.me/kj/duckbrain">Duckbrain</a> supongo que ya la tienes con un webserver nginx o apache en localhost. Si no es el caso, al menos deberás instalarte PHP primero y una ves instalado, abres una terminal en la carpeta donde tienes Duckbrain y ejecutas:
|
Desde luego esta la carpeta con <a href="https://git.kj2.me/kj/duckbrain">Duckbrain</a> supongo que ya la tienes con un webserver nginx o apache en localhost. Si no es el caso, al menos deberás instalarte PHP primero y una ves instalado, abres una terminal en la carpeta donde tienes Duckbrain y ejecutas:
|
||||||
@ -564,8 +552,8 @@ He conocido gente que usa directamente un hosting y edita los archivos allí. Es
|
|||||||
</div>
|
</div>
|
||||||
</div>
|
</div>
|
||||||
|
|
||||||
<div id="outline-container-orgaf9e60a" class="outline-3">
|
<div id="outline-container-org405d525" class="outline-3">
|
||||||
<h3 id="orgaf9e60a"><span class="section-number-3">2.2.</span> Hola mundo</h3>
|
<h3 id="org405d525"><span class="section-number-3">2.2.</span> Hola mundo</h3>
|
||||||
<div class="outline-text-3" id="text-2-2">
|
<div class="outline-text-3" id="text-2-2">
|
||||||
<p>
|
<p>
|
||||||
Agarren su teclado y su editor de código que vamos a comenzar a hacer la magia. Como es usual, el primer paso para hacer nuetra aplicación, será imprimir un <code>hello world</code>.
|
Agarren su teclado y su editor de código que vamos a comenzar a hacer la magia. Como es usual, el primer paso para hacer nuetra aplicación, será imprimir un <code>hello world</code>.
|
||||||
@ -592,8 +580,8 @@ Ahora, siguiendo con el código, abrimos la URL donde estamos corriendo el sitio
|
|||||||
</p>
|
</p>
|
||||||
</div>
|
</div>
|
||||||
|
|
||||||
<div id="outline-container-org1b78df9" class="outline-4">
|
<div id="outline-container-org96ab6d3" class="outline-4">
|
||||||
<h4 id="org1b78df9"><span class="section-number-4">2.2.1.</span> Explicación del código del hola mundo</h4>
|
<h4 id="org96ab6d3"><span class="section-number-4">2.2.1.</span> Explicación del código del hola mundo</h4>
|
||||||
<div class="outline-text-4" id="text-2-2-1">
|
<div class="outline-text-4" id="text-2-2-1">
|
||||||
<p>
|
<p>
|
||||||
Si entendiste el código con solo leerlo, perfecto, pero si no lo hiciste, vamos a explicarlo. Primero vamos a explicar esta parte:
|
Si entendiste el código con solo leerlo, perfecto, pero si no lo hiciste, vamos a explicarlo. Primero vamos a explicar esta parte:
|
||||||
@ -623,7 +611,7 @@ Lo que estámos haciendo aquí, es llamar al método <code>get</code> de la clas
|
|||||||
</p>
|
</p>
|
||||||
|
|
||||||
<p>
|
<p>
|
||||||
Al igual que en <a href="#orgb6ac824">Extra: Namespaces</a> la explicación de las primeras 2 líneas de este código, realmente no es algo de <a href="https://git.kj2.me/kj/duckbrain">Duckbrain</a>, sino del lenguaje mismo, pero de todos modos lo explicaré.
|
Al igual que en <a href="#org2c6b3ec">Extra: Namespaces</a> la explicación de las primeras 2 líneas de este código, realmente no es algo de <a href="https://git.kj2.me/kj/duckbrain">Duckbrain</a>, sino del lenguaje mismo, pero de todos modos lo explicaré.
|
||||||
</p>
|
</p>
|
||||||
|
|
||||||
<p>
|
<p>
|
||||||
@ -663,16 +651,16 @@ Prueba ponerle apodos ambas clases y usar sus distintos nombres en el código. E
|
|||||||
</div>
|
</div>
|
||||||
</div>
|
</div>
|
||||||
|
|
||||||
<div id="outline-container-org3d0bbaa" class="outline-2">
|
<div id="outline-container-org9c2dbee" class="outline-2">
|
||||||
<h2 id="org3d0bbaa"><span class="section-number-2">3.</span> Mi primera aplicación</h2>
|
<h2 id="org9c2dbee"><span class="section-number-2">3.</span> Mi primera aplicación</h2>
|
||||||
<div class="outline-text-2" id="text-3">
|
<div class="outline-text-2" id="text-3">
|
||||||
<p>
|
<p>
|
||||||
Ya hicimos un hola mundo, ahora vamos a hacer algo completo de verdad. Una buena práctica a la hora de crear proyectos es comenzar a definir lo que vamos a hacer, por lo tanto:
|
Ya hicimos un hola mundo, ahora vamos a hacer algo completo de verdad. Una buena práctica a la hora de crear proyectos es comenzar a definir lo que vamos a hacer, por lo tanto:
|
||||||
</p>
|
</p>
|
||||||
</div>
|
</div>
|
||||||
|
|
||||||
<div id="outline-container-org4632ad9" class="outline-3">
|
<div id="outline-container-org98d72c4" class="outline-3">
|
||||||
<h3 id="org4632ad9"><span class="section-number-3">3.1.</span> Definición del proyecto</h3>
|
<h3 id="org98d72c4"><span class="section-number-3">3.1.</span> Definición del proyecto</h3>
|
||||||
<div class="outline-text-3" id="text-3-1">
|
<div class="outline-text-3" id="text-3-1">
|
||||||
<p>
|
<p>
|
||||||
Vamos a hacer un sistema que nos permita compartir textos de manera secreta. Una persona cualquiera podrá entrar a nuestra web, escribir un texto o nota secreta y se le entregará un enlace con el que puede compartir esa nota secreta.
|
Vamos a hacer un sistema que nos permita compartir textos de manera secreta. Una persona cualquiera podrá entrar a nuestra web, escribir un texto o nota secreta y se le entregará un enlace con el que puede compartir esa nota secreta.
|
||||||
@ -692,8 +680,8 @@ El nombre de la aplicación será <b>Ignota</b>. No soy bueno con los nombres y
|
|||||||
</div>
|
</div>
|
||||||
</div>
|
</div>
|
||||||
|
|
||||||
<div id="outline-container-org6399f35" class="outline-3">
|
<div id="outline-container-orga494037" class="outline-3">
|
||||||
<h3 id="org6399f35"><span class="section-number-3">3.2.</span> Base de datos</h3>
|
<h3 id="orga494037"><span class="section-number-3">3.2.</span> Base de datos</h3>
|
||||||
<div class="outline-text-3" id="text-3-2">
|
<div class="outline-text-3" id="text-3-2">
|
||||||
<p>
|
<p>
|
||||||
Este sistema no es algo complicado en lo que al diseño de la base de datos se refiere, por lo que sólo vendría a tener una tabla:
|
Este sistema no es algo complicado en lo que al diseño de la base de datos se refiere, por lo que sólo vendría a tener una tabla:
|
||||||
@ -744,8 +732,8 @@ Voy a obviar la parte de cómo crear las bases de datos ya que ambas cosas se pu
|
|||||||
</p>
|
</p>
|
||||||
</div>
|
</div>
|
||||||
|
|
||||||
<div id="outline-container-org53faac3" class="outline-4">
|
<div id="outline-container-org7401d20" class="outline-4">
|
||||||
<h4 id="org53faac3"><span class="section-number-4">3.2.1.</span> Configuración de Duckbrain para la base de datos</h4>
|
<h4 id="org7401d20"><span class="section-number-4">3.2.1.</span> Configuración de Duckbrain para la base de datos</h4>
|
||||||
<div class="outline-text-4" id="text-3-2-1">
|
<div class="outline-text-4" id="text-3-2-1">
|
||||||
<p>
|
<p>
|
||||||
Desde luego, <a href="https://git.kj2.me/kj/duckbrain">Duckbrain</a> va necesitar tener la información de la base de datos, por lo que abriremos el archivo y veremos algo como esto:
|
Desde luego, <a href="https://git.kj2.me/kj/duckbrain">Duckbrain</a> va necesitar tener la información de la base de datos, por lo que abriremos el archivo y veremos algo como esto:
|
||||||
@ -796,8 +784,8 @@ Como nuestra base de dato es solo un archivo sqlite, no requerimos de <code>DB_H
|
|||||||
</div>
|
</div>
|
||||||
</div>
|
</div>
|
||||||
|
|
||||||
<div id="outline-container-org6650743" class="outline-3">
|
<div id="outline-container-orgf4acd86" class="outline-3">
|
||||||
<h3 id="org6650743"><span class="section-number-3">3.3.</span> Modelos</h3>
|
<h3 id="orgf4acd86"><span class="section-number-3">3.3.</span> Modelos</h3>
|
||||||
<div class="outline-text-3" id="text-3-3">
|
<div class="outline-text-3" id="text-3-3">
|
||||||
<p>
|
<p>
|
||||||
Debo hacer incapié en que nada está escrito en piedra y podemos hacer las cosas de muchas manera con <a href="https://git.kj2.me/kj/duckbrain">Duckbrain</a>, pero en este caso, siguiendo la estructura MVC, vamos a crear modelos, vistas y controladores.
|
Debo hacer incapié en que nada está escrito en piedra y podemos hacer las cosas de muchas manera con <a href="https://git.kj2.me/kj/duckbrain">Duckbrain</a>, pero en este caso, siguiendo la estructura MVC, vamos a crear modelos, vistas y controladores.
|
||||||
@ -865,8 +853,8 @@ Nada de lo mencionado en el anterior párrafo lo necesitaremos, pero de todos mo
|
|||||||
</div>
|
</div>
|
||||||
</div>
|
</div>
|
||||||
|
|
||||||
<div id="outline-container-org091dca6" class="outline-3">
|
<div id="outline-container-org3f20aab" class="outline-3">
|
||||||
<h3 id="org091dca6"><span class="section-number-3">3.4.</span> Creando vistas</h3>
|
<h3 id="org3f20aab"><span class="section-number-3">3.4.</span> Creando vistas</h3>
|
||||||
<div class="outline-text-3" id="text-3-4">
|
<div class="outline-text-3" id="text-3-4">
|
||||||
<p>
|
<p>
|
||||||
En este caso solo necesitaremos una sola vista, por ello no crearemos archivos aparte para el código CSS, sino que irá todo en un solo archivo.
|
En este caso solo necesitaremos una sola vista, por ello no crearemos archivos aparte para el código CSS, sino que irá todo en un solo archivo.
|
||||||
@ -943,8 +931,8 @@ No creo que sea necesario que expliquemos un código html, si no lo entiendes, n
|
|||||||
</div>
|
</div>
|
||||||
</div>
|
</div>
|
||||||
|
|
||||||
<div id="outline-container-org45e7d2c" class="outline-3">
|
<div id="outline-container-org95443fb" class="outline-3">
|
||||||
<h3 id="org45e7d2c"><span class="section-number-3">3.5.</span> Mostrando el formulario</h3>
|
<h3 id="org95443fb"><span class="section-number-3">3.5.</span> Mostrando el formulario</h3>
|
||||||
<div class="outline-text-3" id="text-3-5">
|
<div class="outline-text-3" id="text-3-5">
|
||||||
<p>
|
<p>
|
||||||
Ahora no vamos a hacer un archivos completos, los haremos a pedacitos de código a medida que avancemos.
|
Ahora no vamos a hacer un archivos completos, los haremos a pedacitos de código a medida que avancemos.
|
||||||
@ -1016,8 +1004,8 @@ Ambas funcionarán y al entrar en <code>http://localhost</code> ya
|
|||||||
</p>
|
</p>
|
||||||
</div>
|
</div>
|
||||||
|
|
||||||
<div id="outline-container-org03756c5" class="outline-4">
|
<div id="outline-container-org83a2991" class="outline-4">
|
||||||
<h4 id="org03756c5"><span class="section-number-4">3.5.1.</span> Extra: Explicación del tipo callable</h4>
|
<h4 id="org83a2991"><span class="section-number-4">3.5.1.</span> Extra: Explicación del tipo callable</h4>
|
||||||
<div class="outline-text-4" id="text-3-5-1">
|
<div class="outline-text-4" id="text-3-5-1">
|
||||||
<p>
|
<p>
|
||||||
Enlos anteriores 2 bloques de código lo que hemos visto han sido 2 maneras de escribir un callable:
|
Enlos anteriores 2 bloques de código lo que hemos visto han sido 2 maneras de escribir un callable:
|
||||||
@ -1059,8 +1047,8 @@ Sé que esto es algo raro y que realmente tiene que ver con el conocimiendo de P
|
|||||||
</div>
|
</div>
|
||||||
</div>
|
</div>
|
||||||
|
|
||||||
<div id="outline-container-org1704573" class="outline-3">
|
<div id="outline-container-org7f6f95f" class="outline-3">
|
||||||
<h3 id="org1704573"><span class="section-number-3">3.6.</span> Creando la nota encriptada</h3>
|
<h3 id="org7f6f95f"><span class="section-number-3">3.6.</span> Creando la nota encriptada</h3>
|
||||||
<div class="outline-text-3" id="text-3-6">
|
<div class="outline-text-3" id="text-3-6">
|
||||||
<p>
|
<p>
|
||||||
Ahora que ya tenemos el formulario, ya solo nos queda encriptar y guardar nuestra nota. Para ello comenzaremos agregando la siguiente función a nuestro modelo:
|
Ahora que ya tenemos el formulario, ya solo nos queda encriptar y guardar nuestra nota. Para ello comenzaremos agregando la siguiente función a nuestro modelo:
|
||||||
@ -1151,8 +1139,8 @@ Ahora ya podemos comenzar a crear nuestras notas, auque aún no las podremos ver
|
|||||||
</div>
|
</div>
|
||||||
</div>
|
</div>
|
||||||
|
|
||||||
<div id="outline-container-orgc2600c6" class="outline-3">
|
<div id="outline-container-org9ec9013" class="outline-3">
|
||||||
<h3 id="orgc2600c6"><span class="section-number-3">3.7.</span> Recta final: Desencriptando y mostrando las notas</h3>
|
<h3 id="org9ec9013"><span class="section-number-3">3.7.</span> Recta final: Desencriptando y mostrando las notas</h3>
|
||||||
<div class="outline-text-3" id="text-3-7">
|
<div class="outline-text-3" id="text-3-7">
|
||||||
<p>
|
<p>
|
||||||
Vamos directo al grano, editaremos el modelo (<code>src/Models/Note.php</code>) y le añadiremos esta otra función para desencriptar:
|
Vamos directo al grano, editaremos el modelo (<code>src/Models/Note.php</code>) y le añadiremos esta otra función para desencriptar:
|
||||||
@ -1291,8 +1279,8 @@ Crea una aplicación de gestión tareas (un TODO list), en donde puedas agregar
|
|||||||
</div>
|
</div>
|
||||||
</div>
|
</div>
|
||||||
|
|
||||||
<div id="outline-container-orgb6a2dc7" class="outline-3">
|
<div id="outline-container-orgb6ce768" class="outline-3">
|
||||||
<h3 id="orgb6a2dc7"><span class="section-number-3">3.8.</span> Repositorio</h3>
|
<h3 id="orgb6ce768"><span class="section-number-3">3.8.</span> Repositorio</h3>
|
||||||
<div class="outline-text-3" id="text-3-8">
|
<div class="outline-text-3" id="text-3-8">
|
||||||
<p>
|
<p>
|
||||||
Por si alguien se perdió o sencillamente quiere ver código, he subido la aplicación ignota en este repositorio:
|
Por si alguien se perdió o sencillamente quiere ver código, he subido la aplicación ignota en este repositorio:
|
||||||
@ -1309,8 +1297,8 @@ Te animo a hacerle un fork, mejorarlo y enviármelo. Los forks que me parezcan i
|
|||||||
</div>
|
</div>
|
||||||
</div>
|
</div>
|
||||||
|
|
||||||
<div id="outline-container-org792cd68" class="outline-2">
|
<div id="outline-container-org6070584" class="outline-2">
|
||||||
<h2 id="org792cd68"><span class="section-number-2">4.</span> Contacto</h2>
|
<h2 id="org6070584"><span class="section-number-2">4.</span> Contacto</h2>
|
||||||
<div class="outline-text-2" id="text-4">
|
<div class="outline-text-2" id="text-4">
|
||||||
<p>
|
<p>
|
||||||
Como siempre, pueden contactarme mediante el correo <code>webmaster@outcontol.net</code>
|
Como siempre, pueden contactarme mediante el correo <code>webmaster@outcontol.net</code>
|
||||||
@ -1328,7 +1316,7 @@ No es una comunidad de programación solamente, pero ahora mismo no existe una d
|
|||||||
</div>
|
</div>
|
||||||
<div id="postamble" class="status">
|
<div id="postamble" class="status">
|
||||||
<p class="author">Author: KJ</p>
|
<p class="author">Author: KJ</p>
|
||||||
<p class="date">Created: 2024-05-13 lun 02:02</p>
|
<p class="date">Created: 2024-05-14 mar 02:58</p>
|
||||||
<p class="validation"><a href="https://validator.w3.org/check?uri=referer">Validate</a></p>
|
<p class="validation"><a href="https://validator.w3.org/check?uri=referer">Validate</a></p>
|
||||||
</div>
|
</div>
|
||||||
</body>
|
</body>
|
||||||
|
|||||||
@ -92,21 +92,14 @@ Ahora veamos que hace =index.php=, en la primera línea nos dice esto:
|
|||||||
require_once('config.php');
|
require_once('config.php');
|
||||||
#+end_src
|
#+end_src
|
||||||
|
|
||||||
Aquí carga el archivo =config.php=, o sea, carga la configuración. Para esta parte del manual, solo nos interesa la última línea ya que todo lo demás en realidad no está configurando nada aún. Lo que dice la línea es esto:
|
Aquí carga el archivo =config.php=, o sea, carga la configuración. Para esta parte del manual, solo nos interesa las 2 últimas líneas ya que todo lo demás en realidad no está configurando nada aún. Lo que dice las líneas es esto:
|
||||||
|
|
||||||
#+begin_src php
|
#+begin_src php
|
||||||
define('ROOT_DIR', __DIR__);
|
define('ROOT_DIR', __DIR__);
|
||||||
#+end_src
|
|
||||||
|
|
||||||
Solo está definiendo una constante =ROOT_DIR= que contiene como valor el directorio en donde está el archivo =config.php=, que también sería la raíz de [[https://git.kj2.me/kj/duckbrain][Duckbrain]].
|
|
||||||
|
|
||||||
La siguiente línea también es la definición de una constante:
|
|
||||||
|
|
||||||
#+begin_src php
|
|
||||||
define('ROOT_CORE', ROOT_DIR.'/src');
|
define('ROOT_CORE', ROOT_DIR.'/src');
|
||||||
#+end_src
|
#+end_src
|
||||||
|
|
||||||
Esta constante =ROOT_CORE= lo que hace es tener la ruta de src. Hasta aquí acabamos con la definición de constantes, ahora el bloque que viene es donde se poner lo bueno:
|
Se está definiendo una constante =ROOT_DIR= que contiene como valor el directorio en donde está el archivo =config.php=, que también sería la raíz de [[https://git.kj2.me/kj/duckbrain][Duckbrain]]. La siguiente línea también es la definición de una constante: =ROOT_CORE= lo que hace es tener la ruta de la carpeta =src=. Hasta aquí acabamos con la definición de constantes, ahora el bloque que viene es donde se poner lo bueno:
|
||||||
|
|
||||||
#+begin_src php
|
#+begin_src php
|
||||||
spl_autoload_register(function ($className) {
|
spl_autoload_register(function ($className) {
|
||||||
|
|||||||
Loading…
Reference in New Issue
Block a user