Simplify and fix some paragraphs.
This commit is contained in:
parent
8eac45c1e8
commit
bf740898fa
@ -3,7 +3,7 @@
|
||||
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
|
||||
<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
|
||||
<head>
|
||||
<!-- 2024-09-06 vie 22:27 -->
|
||||
<!-- 2024-09-24 mar 10:27 -->
|
||||
<meta http-equiv="Content-Type" content="text/html;charset=utf-8" />
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1" />
|
||||
<title>Duckbrain - Manual de inicio</title>
|
||||
@ -219,71 +219,67 @@ $(function() { $('.note').before("<p class='admonition-title note'>Note</p>")
|
||||
<h2>Table of Contents</h2>
|
||||
<div id="text-table-of-contents" role="doc-toc">
|
||||
<ul>
|
||||
<li><a href="#orgff88075">1. Introducción</a>
|
||||
<li><a href="#orgbcf01bd">1. Introducción</a>
|
||||
<ul>
|
||||
<li><a href="#org795fd1c">1.1. Estructura de archivos de Duckbrain</a>
|
||||
<li><a href="#org9dc01ed">1.1. Estructura de archivos de Duckbrain</a>
|
||||
<ul>
|
||||
<li><a href="#org456be52">1.1.1. Carpeta src</a></li>
|
||||
<li><a href="#orga881685">1.1.2. Carpetas: Controllers, Libs, Models, Middlewares, Views y Routers</a></li>
|
||||
<li><a href="#org9ae97f2">1.1.3. Los archivos en la raíz</a></li>
|
||||
<li><a href="#org36cd8ca">1.1.4. Los archivos en la carpeta Libs</a></li>
|
||||
<li><a href="#org7f7498c">1.1.1. Carpeta src</a></li>
|
||||
<li><a href="#orgfe2842a">1.1.2. Carpetas: Controllers, Libs, Models, Middlewares, Views y Routers</a></li>
|
||||
<li><a href="#orga6912e1">1.1.3. Los archivos en la raíz</a></li>
|
||||
<li><a href="#orge16f45b">1.1.4. Los archivos en la carpeta Libs</a></li>
|
||||
</ul>
|
||||
</li>
|
||||
<li><a href="#org8700146">1.2. Comprendiendo el arranque del sistema</a></li>
|
||||
<li><a href="#org16ddd15">1.3. Extra: Namespaces</a></li>
|
||||
<li><a href="#org7a91bc2">1.2. Comprendiendo el arranque del sistema</a></li>
|
||||
<li><a href="#org03affa2">1.3. Extra: Namespaces</a></li>
|
||||
</ul>
|
||||
</li>
|
||||
<li><a href="#org3df3d6f">2. Primeros pasos</a>
|
||||
<li><a href="#org73c88fa">2. Primeros pasos</a>
|
||||
<ul>
|
||||
<li><a href="#org90dad41">2.1. Usando un Webserver para el desarrollo</a></li>
|
||||
<li><a href="#orge6c60ce">2.2. Hola mundo</a>
|
||||
<li><a href="#org5a2fb35">2.1. Usando un Webserver para el desarrollo</a></li>
|
||||
<li><a href="#org8534397">2.2. Hola mundo</a>
|
||||
<ul>
|
||||
<li><a href="#org5e488a9">2.2.1. Explicación del código del hola mundo</a></li>
|
||||
<li><a href="#org736e85c">2.2.1. Explicación del código del hola mundo</a></li>
|
||||
</ul>
|
||||
</li>
|
||||
</ul>
|
||||
</li>
|
||||
<li><a href="#org7b80160">3. Mi primera aplicación</a>
|
||||
<li><a href="#org0346fb7">3. Mi primera aplicación</a>
|
||||
<ul>
|
||||
<li><a href="#orgb47bd15">3.1. Definición del proyecto</a></li>
|
||||
<li><a href="#org9bcdc65">3.2. Base de datos</a>
|
||||
<li><a href="#org820a7b0">3.1. Definición del proyecto</a></li>
|
||||
<li><a href="#orgacf6953">3.2. Base de datos</a>
|
||||
<ul>
|
||||
<li><a href="#org3cafd47">3.2.1. Configuración de Duckbrain para la base de datos</a></li>
|
||||
<li><a href="#org4636d76">3.2.1. Configuración de Duckbrain para la base de datos</a></li>
|
||||
</ul>
|
||||
</li>
|
||||
<li><a href="#org08d56f2">3.3. Modelos</a></li>
|
||||
<li><a href="#org600dacb">3.4. Creando vistas</a></li>
|
||||
<li><a href="#org431ee7b">3.5. Mostrando el formulario</a>
|
||||
<li><a href="#orgf77bcfb">3.3. Modelos</a></li>
|
||||
<li><a href="#org4be1876">3.4. Creando vistas</a></li>
|
||||
<li><a href="#org832f1f0">3.5. Mostrando el formulario</a>
|
||||
<ul>
|
||||
<li><a href="#orgdfd194e">3.5.1. Extra: Explicación del tipo callable</a></li>
|
||||
<li><a href="#orgd364a7e">3.5.1. Extra: Explicación del tipo callable</a></li>
|
||||
</ul>
|
||||
</li>
|
||||
<li><a href="#orgc3939ab">3.6. Creando la nota encriptada</a></li>
|
||||
<li><a href="#org6e0596b">3.7. Recta final: Desencriptando y mostrando las notas</a></li>
|
||||
<li><a href="#org55ccc03">3.8. Repositorio</a></li>
|
||||
<li><a href="#org52c1f9d">3.6. Creando la nota encriptada</a></li>
|
||||
<li><a href="#org37189ac">3.7. Recta final: Desencriptando y mostrando las notas</a></li>
|
||||
<li><a href="#org471f476">3.8. Repositorio</a></li>
|
||||
</ul>
|
||||
</li>
|
||||
<li><a href="#org6cba074">4. Contacto</a></li>
|
||||
<li><a href="#orgefeb2e7">4. Contacto</a></li>
|
||||
</ul>
|
||||
</div>
|
||||
</div>
|
||||
<div id="outline-container-orgff88075" class="outline-2">
|
||||
<h2 id="orgff88075"><span class="section-number-2">1.</span> Introducción</h2>
|
||||
<div id="outline-container-orgbcf01bd" class="outline-2">
|
||||
<h2 id="orgbcf01bd"><span class="section-number-2">1.</span> Introducción</h2>
|
||||
<div class="outline-text-2" id="text-1">
|
||||
<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.
|
||||
<a href="https://git.kj2.me/kj/duckbrain">Duckbrain</a> es un conjunto de librerías diseñado para hacer algo simple que cualquiera puede deshacer y rearmar fácilmente. Gracias a su versatilidad, puedes usarlo en cualquier proyecto, pero ten en cuenta que a medida que el proyecto sea más grande, también lo será la ingeniería necesaria de tu parte para adaptarlo a los requisitos.
|
||||
</p>
|
||||
|
||||
<p>
|
||||
Gracias a esa versatilidad, puedes usarlo cualquier proyecto, pero 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.
|
||||
</p>
|
||||
|
||||
<p>
|
||||
Otro punto fuerte que puedo dar de esta herramienta, es que te puede ser tremendamente útil si estás comenzando, ya que al ser tan pequeño y modificable, es más sencillo que lo comprendas y esto más adelante te ayudará a comprender cosas más grandes.
|
||||
Otro punto a tener en cuenta es que Duckbrain puede ser muy útil si estás comenzando, ya que su pequeñez y modficabilidad hacen que sea más fácil de comprender y, a medida que avances, te ayudará a entender cosas más grandes.
|
||||
</p>
|
||||
</div>
|
||||
<div id="outline-container-org795fd1c" class="outline-3">
|
||||
<h3 id="org795fd1c"><span class="section-number-3">1.1.</span> Estructura de archivos de Duckbrain</h3>
|
||||
<div id="outline-container-org9dc01ed" class="outline-3">
|
||||
<h3 id="org9dc01ed"><span class="section-number-3">1.1.</span> Estructura de archivos de Duckbrain</h3>
|
||||
<div class="outline-text-3" id="text-1-1">
|
||||
<p>
|
||||
Al entrar a la carpeta de Duckbrain encontrarás esta estructura de archivos (ignoramos el readme.org por obvias razones).
|
||||
@ -312,42 +308,38 @@ Al entrar a la carpeta de Duckbrain encontrarás esta estructura de archivos (ig
|
||||
</div>
|
||||
|
||||
<p>
|
||||
Primero veamos las carpetas y luego los archivos:
|
||||
Primero, observemos las carpetas y luego los archivos:
|
||||
</p>
|
||||
</div>
|
||||
<div id="outline-container-org456be52" class="outline-4">
|
||||
<h4 id="org456be52"><span class="section-number-4">1.1.1.</span> Carpeta src</h4>
|
||||
<div id="outline-container-org7f7498c" class="outline-4">
|
||||
<h4 id="org7f7498c"><span class="section-number-4">1.1.1.</span> Carpeta src</h4>
|
||||
<div class="outline-text-4" id="text-1-1-1">
|
||||
<p>
|
||||
En esta carpeta se encuentra todo el código PHP de lo que será nuestro proyecto. Es posible cambiarle el nombre/ruta a gusto, como te darás cuenta más adelante.
|
||||
</p>
|
||||
</div>
|
||||
</div>
|
||||
<div id="outline-container-orga881685" class="outline-4">
|
||||
<h4 id="orga881685"><span class="section-number-4">1.1.2.</span> Carpetas: Controllers, Libs, Models, Middlewares, Views y Routers</h4>
|
||||
<div id="outline-container-orgfe2842a" class="outline-4">
|
||||
<h4 id="orgfe2842a"><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">
|
||||
<p>
|
||||
Si sabes de estructuras de diseño, ya te debe quedar claro qué va en cada una de estas carpetas, puesto que en el nombre de las mismas lo indica.
|
||||
Si sabes de estructuras de diseño de software, ya entenderás qué va en cada una de estas carpetas. Si no, es momento de investigar por lo menos lo que significa la arquitectura MVC, ya que es una arquitectura simple bastante común y lo que usaremos en este manual.
|
||||
</p>
|
||||
|
||||
<p>
|
||||
Si no sabes que es un Model, un Middleware, Controller, etc. entonces requieres buscar ahora mismo lo que es una arquitectura de diseño de software y leerte al menos en qué consiste la arquitectura de MVC, ya que es una arquitectura simple y la que usaremos más adelante en este manual. Si lo comprendes, solo sigue leyendo.
|
||||
Al igual que con la carpeta <code>src</code>, puedes cambiar y organizar las carpetas según tus necesidades. Solo ten cuidado de modificar los archivos asociados a las carpetas Views y Router, ya que afectarían al archivo <code>src/Libs/View.php</code> y el archivo <code>index.php</code>, respectivamente. En todo caso, mejor no hagas cambios en las rutas carpetas antes de completar po lo menos la sección <a href="#org0346fb7">Mi primera aplicación</a>.
|
||||
</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="#org7b80160">Mi primera aplicación</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>
|
||||
Desde luego, si eres un ansias y ya has programado antes en alguna arquitectura de diseño como DDD, MVC, TDD, EDD, etc. y manejas decentemente PHP, con que te leas el código del archivo <code>index.php</code> (son solo 20 líneas de código) te deberá bastar y puedes saltarte el resto del este manual y guiarte de ahora en adelante con la documentación de los comentarios (docblocks) de las librerías.
|
||||
Si eres un ansias y ya has programado antes en alguna arquitectura de diseño como DDD, MVC, TDD, EDD, etc. y manejas decentemente PHP, con que te leas el código del archivo <code>index.php</code> (son solo 20 líneas de código) te deberá bastar y puedes saltarte el resto del este manual y guiarte de ahora en adelante con la documentación de los comentarios (docblocks) de las librerías.
|
||||
</p>
|
||||
</div>
|
||||
</div>
|
||||
<div id="outline-container-org9ae97f2" class="outline-4">
|
||||
<h4 id="org9ae97f2"><span class="section-number-4">1.1.3.</span> Los archivos en la raíz</h4>
|
||||
<div id="outline-container-orga6912e1" class="outline-4">
|
||||
<h4 id="orga6912e1"><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">
|
||||
<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. Contiene 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> a pesar de que la carpeta <code>mi-ruta-virtual</code> no exista.
|
||||
El <code>.htaccess</code> es un archivo que te será útil si usas <a href="https://httpd.apache.org/">Apache</a> o algún otro servidor similar. Contiene una configuración especial para que funcionen las <b>rutas virtuales</b>, o sea, para que podamos crear una ruta tipo <code>misitio.com/mi-ruta-virtual/</code> a pesar de que la carpeta <code>mi-ruta-virtual</code> no exista.
|
||||
</p>
|
||||
|
||||
<p>
|
||||
@ -362,7 +354,7 @@ En caso de que uses nginx, debes configurar el webserver con la regla equivalent
|
||||
</div>
|
||||
|
||||
<p>
|
||||
El archivo <code>index.php</code> es el punto de entrada de nuestra aplicación, aquí sucederá toda la magia inicial y sólo requiere de 20 míseras lineas para hacer ese gran trabajo y soportar sistemas tan grandes sin despeinarse ante frameworks más complejos como laravel o que son usados por cientos de miles de usuarios en cientos de instalaciones. Esto lo menciono no por creer que ttps://git.kj2.me/kj/duckbrain][Duckbrain podría soportarlo, sino porque es algo que ya sucede, o sea, dichos sistemas ya existen: Los he hecho yo o he estado involucrado en parte del proyecto al punto de poder elegir <a href="https://git.kj2.me/kj/duckbrain">Duckbrain</a> como base para el mismo.
|
||||
El archivo <code>index.php</code> es el punto de entrada de nuestra aplicación, aquí sucederá toda la magia inicial y sólo requiere de 20 míseras lineas para hacer ese gran trabajo y soportar sistemas tan grandes sin despeinarse.
|
||||
</p>
|
||||
|
||||
<p>
|
||||
@ -370,17 +362,17 @@ El archivo <code>config.php</code>, como su nombre indica, es el archivo para co
|
||||
</p>
|
||||
</div>
|
||||
</div>
|
||||
<div id="outline-container-org36cd8ca" class="outline-4">
|
||||
<h4 id="org36cd8ca"><span class="section-number-4">1.1.4.</span> Los archivos en la carpeta Libs</h4>
|
||||
<div id="outline-container-orge16f45b" class="outline-4">
|
||||
<h4 id="orge16f45b"><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">
|
||||
<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.
|
||||
Los archivos en la carpeta "Libs" son principalmente librerías. Cada archivo tiene un nombre descriptivo que indica su función. Si tienes conocimientos básicos sobre diseño y lees los nombres de estas librerías, deberías poder comprender lo que hacen. Si no lo entiendes con solo eso, sigue leyendo el manual que hablaremos de casi todas poco a poco.
|
||||
</p>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
<div id="outline-container-org8700146" class="outline-3">
|
||||
<h3 id="org8700146"><span class="section-number-3">1.2.</span> Comprendiendo el arranque del sistema</h3>
|
||||
<div id="outline-container-org7a91bc2" class="outline-3">
|
||||
<h3 id="org7a91bc2"><span class="section-number-3">1.2.</span> Comprendiendo el arranque del sistema</h3>
|
||||
<div class="outline-text-3" id="text-1-2">
|
||||
<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.
|
||||
@ -399,7 +391,7 @@ Primero intenta comprobar si el fichero "hola" existe en la ruta a la que se des
|
||||
</p>
|
||||
|
||||
<p>
|
||||
Si llega hasta la tercera opción decimos que es una <b>ruta virtual</b> (lo que mencionamos en <a href="#org9ae97f2">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.
|
||||
Si llega hasta la tercera opción decimos que es una <b>ruta virtual</b> (lo que mencionamos en <a href="#orga6912e1">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>
|
||||
@ -407,7 +399,7 @@ Ahora veamos que hace <code>index.php</code>, en la primera línea nos dice esto
|
||||
</p>
|
||||
|
||||
<div class="org-src-container">
|
||||
<pre class="src src-php"><span style="color: #A52A2A; font-weight: bold;">require_once</span>(<span style="color: #4E9A06;">'config.php'</span>);
|
||||
<pre class="src src-php"><span style="color: #204A87;">require_once('config.php');</span>
|
||||
</pre>
|
||||
</div>
|
||||
|
||||
@ -416,8 +408,8 @@ Aquí carga el archivo <code>config.php</code>, o sea, carga la configuración.
|
||||
</p>
|
||||
|
||||
<div class="org-src-container">
|
||||
<pre class="src src-php">define(<span style="color: #4E9A06;">'ROOT_DIR'</span>, <span style="color: #A020F0;">__DIR__</span>);
|
||||
define(<span style="color: #4E9A06;">'ROOT_CORE'</span>, <span style="color: #F5666D;">ROOT_DIR</span>.<span style="color: #4E9A06;">'/src'</span>);
|
||||
<pre class="src src-php"><span style="color: #204A87;">define('ROOT_DIR', __DIR__);</span>
|
||||
<span style="color: #204A87;">define('ROOT_CORE', ROOT_DIR.'/src');</span>
|
||||
</pre>
|
||||
</div>
|
||||
|
||||
@ -426,16 +418,16 @@ Se está definiendo una constante <code>ROOT_DIR</code> que contiene como valor
|
||||
</p>
|
||||
|
||||
<div class="org-src-container">
|
||||
<pre class="src src-php">spl_autoload_register(<span style="color: #A52A2A; font-weight: bold;">function</span> ($<span style="color: #0084C8; font-weight: bold;">className</span>) {
|
||||
$<span style="color: #0084C8; font-weight: bold;">fp</span> = str_replace(<span style="color: #4E9A06;">'</span><span style="color: #4E9A06; font-weight: bold;">\</span><span style="color: #4E9A06; font-weight: bold;">\</span><span style="color: #4E9A06;">'</span>,<span style="color: #4E9A06;">'/'</span>,$<span style="color: #0084C8; font-weight: bold;">className</span>);
|
||||
$<span style="color: #0084C8; font-weight: bold;">name</span> = basename($<span style="color: #0084C8; font-weight: bold;">fp</span>);
|
||||
$<span style="color: #0084C8; font-weight: bold;">dir</span> = dirname($<span style="color: #0084C8; font-weight: bold;">fp</span>);
|
||||
$<span style="color: #0084C8; font-weight: bold;">file</span> = <span style="color: #F5666D;">ROOT_CORE</span>.<span style="color: #4E9A06;">'/'</span>.$<span style="color: #0084C8; font-weight: bold;">dir</span>.<span style="color: #4E9A06;">'/'</span>.$<span style="color: #0084C8; font-weight: bold;">name</span>.<span style="color: #4E9A06;">'.php'</span>;
|
||||
<span style="color: #A52A2A; font-weight: bold;">if</span> (file_exists($<span style="color: #0084C8; font-weight: bold;">file</span>)) {
|
||||
<span style="color: #A52A2A; font-weight: bold;">require_once</span> $<span style="color: #0084C8; font-weight: bold;">file</span>;
|
||||
<span style="color: #A52A2A; font-weight: bold;">return</span>;
|
||||
}
|
||||
});
|
||||
<pre class="src src-php"><span style="color: #204A87;">spl_autoload_register(function ($className) {</span>
|
||||
<span style="color: #204A87;"> $fp = str_replace('</span><span style="color: #204A87; font-weight: bold;">\</span><span style="color: #204A87; font-weight: bold;">\</span><span style="color: #204A87;">','/',$className);</span>
|
||||
<span style="color: #204A87;"> $name = basename($fp);</span>
|
||||
<span style="color: #204A87;"> $dir = dirname($fp);</span>
|
||||
<span style="color: #204A87;"> $file = ROOT_CORE.'/'.$dir.'/'.$name.'.php';</span>
|
||||
<span style="color: #204A87;"> if (file_exists($file)) {</span>
|
||||
<span style="color: #204A87;"> require_once $file;</span>
|
||||
<span style="color: #204A87;"> return;</span>
|
||||
<span style="color: #204A87;"> }</span>
|
||||
<span style="color: #204A87;">});</span>
|
||||
</pre>
|
||||
</div>
|
||||
|
||||
@ -452,13 +444,13 @@ Si aún no lo entendiste, no pierdas tiempo releyendo el párrafo anterior, en s
|
||||
</p>
|
||||
|
||||
<div class="org-src-container">
|
||||
<pre class="src src-php">$<span style="color: #0084C8; font-weight: bold;">routers</span> = glob(<span style="color: #F5666D;">ROOT_CORE</span>.<span style="color: #4E9A06;">'/Routers/*.php'</span>);
|
||||
<pre class="src src-php"><span style="color: #204A87;">$routers = glob(ROOT_CORE.'/Routers/*.php');</span>
|
||||
|
||||
<span style="color: #A52A2A; font-weight: bold;">foreach</span>($<span style="color: #0084C8; font-weight: bold;">routers</span> <span style="color: #A52A2A; font-weight: bold;">as</span> $<span style="color: #0084C8; font-weight: bold;">file</span>){
|
||||
<span style="color: #A52A2A; font-weight: bold;">require_once</span>($<span style="color: #0084C8; font-weight: bold;">file</span>);
|
||||
}
|
||||
<span style="color: #204A87;">foreach($routers as $file){</span>
|
||||
<span style="color: #204A87;"> require_once($file);</span>
|
||||
<span style="color: #204A87;">}</span>
|
||||
|
||||
<span style="color: #F5666D;">\Libs\Router</span>::apply();
|
||||
<span style="color: #204A87;">\Libs\Router::apply();</span>
|
||||
</pre>
|
||||
</div>
|
||||
|
||||
@ -475,8 +467,8 @@ Nótese que lo que ha hecho el autoloader es convertir los backslashes o barras
|
||||
</p>
|
||||
</div>
|
||||
</div>
|
||||
<div id="outline-container-org16ddd15" class="outline-3">
|
||||
<h3 id="org16ddd15"><span class="section-number-3">1.3.</span> Extra: Namespaces</h3>
|
||||
<div id="outline-container-org03affa2" class="outline-3">
|
||||
<h3 id="org03affa2"><span class="section-number-3">1.3.</span> Extra: Namespaces</h3>
|
||||
<div class="outline-text-3" id="text-1-3">
|
||||
<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.
|
||||
@ -487,7 +479,7 @@ Si abres el archivo <code>src/Libs/Router.php</code> verás que en su primera l
|
||||
</p>
|
||||
|
||||
<div class="org-src-container">
|
||||
<pre class="src src-php"><span style="color: #A52A2A; font-weight: bold;">namespace</span> <span style="color: #2F8B58; font-weight: bold;">Libs</span>;
|
||||
<pre class="src src-php"><span style="color: #204A87;">namespace Libs;</span>
|
||||
</pre>
|
||||
</div>
|
||||
|
||||
@ -505,15 +497,15 @@ Puede que ahora mismo no notes la utilidad de esto, pero es algo muy útil realm
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
<div id="outline-container-org3df3d6f" class="outline-2">
|
||||
<h2 id="org3df3d6f"><span class="section-number-2">2.</span> Primeros pasos</h2>
|
||||
<div id="outline-container-org73c88fa" class="outline-2">
|
||||
<h2 id="org73c88fa"><span class="section-number-2">2.</span> Primeros pasos</h2>
|
||||
<div class="outline-text-2" id="text-2">
|
||||
<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.
|
||||
</p>
|
||||
</div>
|
||||
<div id="outline-container-org90dad41" class="outline-3">
|
||||
<h3 id="org90dad41"><span class="section-number-3">2.1.</span> Usando un Webserver para el desarrollo</h3>
|
||||
<div id="outline-container-org5a2fb35" class="outline-3">
|
||||
<h3 id="org5a2fb35"><span class="section-number-3">2.1.</span> Usando un Webserver para el desarrollo</h3>
|
||||
<div class="outline-text-3" id="text-2-1">
|
||||
<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:
|
||||
@ -537,8 +529,8 @@ He conocido gente que usa directamente un hosting y edita los archivos allí. Es
|
||||
</p>
|
||||
</div>
|
||||
</div>
|
||||
<div id="outline-container-orge6c60ce" class="outline-3">
|
||||
<h3 id="orge6c60ce"><span class="section-number-3">2.2.</span> Hola mundo</h3>
|
||||
<div id="outline-container-org8534397" class="outline-3">
|
||||
<h3 id="org8534397"><span class="section-number-3">2.2.</span> Hola mundo</h3>
|
||||
<div class="outline-text-3" id="text-2-2">
|
||||
<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>.
|
||||
@ -550,8 +542,8 @@ Para ello vamos a la carpeta <code>src/Routers</code> y crearemos un archivo con
|
||||
|
||||
<div class="org-src-container">
|
||||
<pre class="src src-php"><span style="color: #A020F0;"><?php</span>
|
||||
<span style="color: #A52A2A; font-weight: bold;">use</span> <span style="color: #2F8B58; font-weight: bold;">Libs\Request</span>;
|
||||
<span style="color: #A52A2A; font-weight: bold;">use</span> <span style="color: #2F8B58; font-weight: bold;">Libs\Router</span>;
|
||||
<span style="color: #A52A2A; font-weight: bold;">use</span> <span style="color: #2F8B58; font-weight: bold;">Libs</span>\<span style="color: #F5666D;">Request</span>;
|
||||
<span style="color: #A52A2A; font-weight: bold;">use</span> <span style="color: #2F8B58; font-weight: bold;">Libs</span>\<span style="color: #F5666D;">Router</span>;
|
||||
|
||||
<span style="color: #F5666D;">Router</span>::get(<span style="color: #4E9A06;">'/'</span>, <span style="color: #A52A2A; font-weight: bold;">function</span>(<span style="color: #2F8B58; font-weight: bold;">Request</span> $<span style="color: #0084C8; font-weight: bold;">requets</span>) {
|
||||
<span style="color: #A52A2A; font-weight: bold;">echo</span> <span style="color: #4E9A06;">"Hola mundo"</span>;
|
||||
@ -564,17 +556,17 @@ Para ello vamos a la carpeta <code>src/Routers</code> y crearemos un archivo con
|
||||
Ahora, siguiendo con el código, abrimos la URL donde estamos corriendo el sitio (normalmente localhost) y veremos nuestro esperado "hola mundo".
|
||||
</p>
|
||||
</div>
|
||||
<div id="outline-container-org5e488a9" class="outline-4">
|
||||
<h4 id="org5e488a9"><span class="section-number-4">2.2.1.</span> Explicación del código del hola mundo</h4>
|
||||
<div id="outline-container-org736e85c" class="outline-4">
|
||||
<h4 id="org736e85c"><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">
|
||||
<p>
|
||||
Si entendiste el código con solo leerlo, perfecto, pero si no lo hiciste, vamos a explicarlo. Primero vamos a explicar esta parte:
|
||||
</p>
|
||||
|
||||
<div class="org-src-container">
|
||||
<pre class="src src-php"><span style="color: #F5666D;">Router</span>::get(<span style="color: #4E9A06;">'/'</span>, <span style="color: #A52A2A; font-weight: bold;">function</span>(<span style="color: #2F8B58; font-weight: bold;">Request</span> $<span style="color: #0084C8; font-weight: bold;">requets</span>) {
|
||||
<span style="color: #A52A2A; font-weight: bold;">echo</span> <span style="color: #4E9A06;">"Hola mundo"</span>;
|
||||
});
|
||||
<pre class="src src-php"><span style="color: #204A87;">Router::get('/', function(Request $requets) {</span>
|
||||
<span style="color: #204A87;"> echo "Hola mundo";</span>
|
||||
<span style="color: #204A87;">});</span>
|
||||
</pre>
|
||||
</div>
|
||||
|
||||
@ -595,7 +587,7 @@ Lo que estámos haciendo aquí, es llamar al método <code>get</code> de la clas
|
||||
</p>
|
||||
|
||||
<p>
|
||||
Al igual que en <a href="#org16ddd15">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="#org03affa2">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>
|
||||
@ -604,7 +596,7 @@ Primero que nada, si no quisieramos o no tuviéramos la posibilidad de usar <cod
|
||||
|
||||
<div class="org-src-container">
|
||||
<pre class="src src-php"><span style="color: #A020F0;"><?php</span>
|
||||
<span style="color: #F5666D;">Libs\Router</span>::get(<span style="color: #4E9A06;">'/'</span>, <span style="color: #A52A2A; font-weight: bold;">function</span>(<span style="color: #2F8B58; font-weight: bold;">Libs\Request</span> $<span style="color: #0084C8; font-weight: bold;">requets</span>) {
|
||||
<span style="color: #2F8B58; font-weight: bold;">Libs</span>\<span style="color: #F5666D;">Router</span>::get(<span style="color: #4E9A06;">'/'</span>, <span style="color: #A52A2A; font-weight: bold;">function</span>(<span style="color: #2F8B58; font-weight: bold;">Libs</span>\<span style="color: #F5666D;">Request</span> $<span style="color: #0084C8; font-weight: bold;">requets</span>) {
|
||||
<span style="color: #A52A2A; font-weight: bold;">echo</span> <span style="color: #4E9A06;">"Hola mundo"</span>;
|
||||
});
|
||||
</pre>
|
||||
@ -619,7 +611,7 @@ Si un <code>namespace</code> es como dar un apellido, <code>use</code> es como d
|
||||
</p>
|
||||
|
||||
<div class="org-src-container">
|
||||
<pre class="src src-php"><span style="color: #A52A2A; font-weight: bold;">use</span> <span style="color: #2F8B58; font-weight: bold;">Libs\Router</span> <span style="color: #A52A2A; font-weight: bold;">as</span> <span style="color: #2F8B58; font-weight: bold;">Rutercito</span>;
|
||||
<pre class="src src-php"><span style="color: #204A87;">use Libs\Router as Rutercito;</span>
|
||||
</pre>
|
||||
</div>
|
||||
|
||||
@ -634,15 +626,15 @@ Prueba ponerle apodos ambas clases y usar sus distintos nombres en el código. E
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
<div id="outline-container-org7b80160" class="outline-2">
|
||||
<h2 id="org7b80160"><span class="section-number-2">3.</span> Mi primera aplicación</h2>
|
||||
<div id="outline-container-org0346fb7" class="outline-2">
|
||||
<h2 id="org0346fb7"><span class="section-number-2">3.</span> Mi primera aplicación</h2>
|
||||
<div class="outline-text-2" id="text-3">
|
||||
<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:
|
||||
</p>
|
||||
</div>
|
||||
<div id="outline-container-orgb47bd15" class="outline-3">
|
||||
<h3 id="orgb47bd15"><span class="section-number-3">3.1.</span> Definición del proyecto</h3>
|
||||
<div id="outline-container-org820a7b0" class="outline-3">
|
||||
<h3 id="org820a7b0"><span class="section-number-3">3.1.</span> Definición del proyecto</h3>
|
||||
<div class="outline-text-3" id="text-3-1">
|
||||
<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.
|
||||
@ -661,8 +653,8 @@ El nombre de la aplicación será <b>Ignota</b>. No soy bueno con los nombres y
|
||||
</p>
|
||||
</div>
|
||||
</div>
|
||||
<div id="outline-container-org9bcdc65" class="outline-3">
|
||||
<h3 id="org9bcdc65"><span class="section-number-3">3.2.</span> Base de datos</h3>
|
||||
<div id="outline-container-orgacf6953" class="outline-3">
|
||||
<h3 id="orgacf6953"><span class="section-number-3">3.2.</span> Base de datos</h3>
|
||||
<div class="outline-text-3" id="text-3-2">
|
||||
<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:
|
||||
@ -712,8 +704,8 @@ El código para crear las tablas en SQLite sería este:
|
||||
Voy a obviar la parte de cómo crear las bases de datos ya que ambas cosas se pueden encontrar fácil, ya sea preguntando o buscando por cuenta propia. Desde luego, si son muy nuevos, recomiendo que usen SQLite que es la más sencilla de las 2 opciones y por ello también usaremos esa opción de ahora en adelante.
|
||||
</p>
|
||||
</div>
|
||||
<div id="outline-container-org3cafd47" class="outline-4">
|
||||
<h4 id="org3cafd47"><span class="section-number-4">3.2.1.</span> Configuración de Duckbrain para la base de datos</h4>
|
||||
<div id="outline-container-org4636d76" class="outline-4">
|
||||
<h4 id="org4636d76"><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">
|
||||
<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:
|
||||
@ -727,10 +719,10 @@ define(<span style="color: #4E9A06;">'DB_NAME'</span>, <span style="color: #4E9A
|
||||
define(<span style="color: #4E9A06;">'DB_USER'</span>, <span style="color: #4E9A06;">''</span>);
|
||||
define(<span style="color: #4E9A06;">'DB_PASS'</span>, <span style="color: #4E9A06;">''</span>);
|
||||
|
||||
<span style="color: #204A87;">//</span><span style="color: #204A87;">define('SITE_URL', '');</span>
|
||||
<span style="color: #204A87;">//define('SITE_URL', '');</span>
|
||||
|
||||
define(<span style="color: #4E9A06;">'ROOT_DIR'</span>, <span style="color: #A020F0;">__DIR__</span>);
|
||||
<span style="color: #A020F0;">?></span>
|
||||
define(<span style="color: #4E9A06;">'ROOT_CORE'</span>, <span style="color: #F5666D;">ROOT_DIR</span>.<span style="color: #4E9A06;">'/src'</span>);
|
||||
</pre>
|
||||
</div>
|
||||
|
||||
@ -753,7 +745,7 @@ define(<span style="color: #4E9A06;">'DB_PASS'</span>, <span style="color: #4E9A
|
||||
define(<span style="color: #4E9A06;">'SITE_URL'</span>, <span style="color: #4E9A06;">'http://localhost/'</span>);
|
||||
|
||||
define(<span style="color: #4E9A06;">'ROOT_DIR'</span>, <span style="color: #A020F0;">__DIR__</span>);
|
||||
<span style="color: #A020F0;">?></span>
|
||||
define(<span style="color: #4E9A06;">'ROOT_CORE'</span>, <span style="color: #F5666D;">ROOT_DIR</span>.<span style="color: #4E9A06;">'/src'</span>);
|
||||
</pre>
|
||||
</div>
|
||||
|
||||
@ -763,8 +755,8 @@ Como nuestra base de dato es solo un archivo sqlite, no requerimos de <code>DB_H
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
<div id="outline-container-org08d56f2" class="outline-3">
|
||||
<h3 id="org08d56f2"><span class="section-number-3">3.3.</span> Modelos</h3>
|
||||
<div id="outline-container-orgf77bcfb" class="outline-3">
|
||||
<h3 id="orgf77bcfb"><span class="section-number-3">3.3.</span> Modelos</h3>
|
||||
<div class="outline-text-3" id="text-3-3">
|
||||
<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.
|
||||
@ -778,7 +770,7 @@ Comenzando con los modelos, que en realidad para este proyecto sería en singula
|
||||
<pre class="src src-php"><span style="color: #A020F0;"><?php</span>
|
||||
<span style="color: #A52A2A; font-weight: bold;">namespace</span> <span style="color: #2F8B58; font-weight: bold;">Models</span>;
|
||||
|
||||
<span style="color: #A52A2A; font-weight: bold;">use</span> <span style="color: #2F8B58; font-weight: bold;">Libs\Model</span>;
|
||||
<span style="color: #A52A2A; font-weight: bold;">use</span> <span style="color: #2F8B58; font-weight: bold;">Libs</span>\<span style="color: #F5666D;">Model</span>;
|
||||
|
||||
<span style="color: #A52A2A; font-weight: bold;">class</span> <span style="color: #2F8B58; font-weight: bold;">Note</span> <span style="color: #A52A2A; font-weight: bold;">extends</span> <span style="color: #2F8B58; font-weight: bold;">Model</span> {
|
||||
<span style="color: #A52A2A; font-weight: bold;">public</span> <span style="color: #2F8B58; font-weight: bold;">string</span> $<span style="color: #0084C8; font-weight: bold;">content</span>;
|
||||
@ -804,7 +796,7 @@ Nada de lo mencionado en el anterior párrafo lo necesitaremos, pero de todos mo
|
||||
<pre class="src src-php"><span style="color: #A020F0;"><?php</span>
|
||||
<span style="color: #A52A2A; font-weight: bold;">namespace</span> <span style="color: #2F8B58; font-weight: bold;">Models</span>;
|
||||
|
||||
<span style="color: #A52A2A; font-weight: bold;">use</span> <span style="color: #2F8B58; font-weight: bold;">Libs\Model</span>;
|
||||
<span style="color: #A52A2A; font-weight: bold;">use</span> <span style="color: #2F8B58; font-weight: bold;">Libs</span>\<span style="color: #F5666D;">Model</span>;
|
||||
|
||||
<span style="color: #A52A2A; font-weight: bold;">class</span> <span style="color: #2F8B58; font-weight: bold;">Note</span> <span style="color: #A52A2A; font-weight: bold;">extends</span> <span style="color: #2F8B58; font-weight: bold;">Model</span> {
|
||||
<span style="color: #A52A2A; font-weight: bold;">public</span> <span style="color: #2F8B58; font-weight: bold;">string</span> $<span style="color: #0084C8; font-weight: bold;">content</span>;
|
||||
@ -814,13 +806,13 @@ Nada de lo mencionado en el anterior párrafo lo necesitaremos, pero de todos mo
|
||||
<span style="color: #A52A2A; font-weight: bold;">private</span> <span style="color: #2F8B58; font-weight: bold;">string</span> $<span style="color: #0084C8; font-weight: bold;">password</span>;
|
||||
<span style="color: #A52A2A; font-weight: bold;">protected</span> <span style="color: #2F8B58; font-weight: bold;">string</span> $<span style="color: #0084C8; font-weight: bold;">salt</span>;
|
||||
|
||||
<span style="color: #204A87;">// </span><span style="color: #204A87;">Cambiamos el nombre de la tabla a la que se relacionará nuestro modelo.</span>
|
||||
<span style="color: #204A87;">// Cambiamos el nombre de la tabla a la que se relacionará nuestro modelo.</span>
|
||||
<span style="color: #A52A2A; font-weight: bold;">static</span> <span style="color: #A52A2A; font-weight: bold;">protected</span> <span style="color: #2F8B58; font-weight: bold;">string</span> $<span style="color: #0084C8; font-weight: bold;">table</span> = <span style="color: #4E9A06;">'se_llama_como_YO_quiero_AAAhh'</span>;
|
||||
|
||||
<span style="color: #204A87;">// </span><span style="color: #204A87;">Forzamos a que se guarden las propiedades salt y password a pesar de que no son públicas.</span>
|
||||
<span style="color: #204A87;">// Forzamos a que se guarden las propiedades salt y password a pesar de que no son públicas.</span>
|
||||
<span style="color: #A52A2A; font-weight: bold;">static</span> <span style="color: #A52A2A; font-weight: bold;">protected</span> <span style="color: #2F8B58; font-weight: bold;">array</span> $<span style="color: #0084C8; font-weight: bold;">forceSave</span> = [<span style="color: #4E9A06;">'password'</span>, <span style="color: #4E9A06;">'salt'</span>];
|
||||
|
||||
<span style="color: #204A87;">// </span><span style="color: #204A87;">Frozamos a no guuardar la propiedad pública tmp_cache</span>
|
||||
<span style="color: #204A87;">// Frozamos a no guuardar la propiedad pública tmp_cache</span>
|
||||
<span style="color: #A52A2A; font-weight: bold;">static</span> <span style="color: #A52A2A; font-weight: bold;">protected</span> <span style="color: #2F8B58; font-weight: bold;">array</span> $<span style="color: #0084C8; font-weight: bold;">ignoreSave</span> = [<span style="color: #4E9A06;">'tmp_cache'</span>];
|
||||
}
|
||||
</pre>
|
||||
@ -831,8 +823,8 @@ Nada de lo mencionado en el anterior párrafo lo necesitaremos, pero de todos mo
|
||||
</p>
|
||||
</div>
|
||||
</div>
|
||||
<div id="outline-container-org600dacb" class="outline-3">
|
||||
<h3 id="org600dacb"><span class="section-number-3">3.4.</span> Creando vistas</h3>
|
||||
<div id="outline-container-org4be1876" class="outline-3">
|
||||
<h3 id="org4be1876"><span class="section-number-3">3.4.</span> Creando vistas</h3>
|
||||
<div class="outline-text-3" id="text-3-4">
|
||||
<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.
|
||||
@ -908,8 +900,8 @@ No creo que sea necesario que expliquemos un código html, si no lo entiendes, n
|
||||
</p>
|
||||
</div>
|
||||
</div>
|
||||
<div id="outline-container-org431ee7b" class="outline-3">
|
||||
<h3 id="org431ee7b"><span class="section-number-3">3.5.</span> Mostrando el formulario</h3>
|
||||
<div id="outline-container-org832f1f0" class="outline-3">
|
||||
<h3 id="org832f1f0"><span class="section-number-3">3.5.</span> Mostrando el formulario</h3>
|
||||
<div class="outline-text-3" id="text-3-5">
|
||||
<p>
|
||||
Ahora no vamos a hacer un archivos completos, los haremos a pedacitos de código a medida que avancemos.
|
||||
@ -923,11 +915,11 @@ Comenzando con el controlador, vamos a crear un archivo llamado <code>NoteContro
|
||||
<pre class="src src-php"><span style="color: #A020F0;"><?php</span>
|
||||
<span style="color: #A52A2A; font-weight: bold;">namespace</span> <span style="color: #2F8B58; font-weight: bold;">Controllers</span>;
|
||||
|
||||
<span style="color: #A52A2A; font-weight: bold;">use</span> <span style="color: #2F8B58; font-weight: bold;">Libs\Request</span>;
|
||||
<span style="color: #A52A2A; font-weight: bold;">use</span> <span style="color: #2F8B58; font-weight: bold;">Libs\View</span>;
|
||||
<span style="color: #A52A2A; font-weight: bold;">use</span> <span style="color: #2F8B58; font-weight: bold;">Libs</span>\<span style="color: #F5666D;">Request</span>;
|
||||
<span style="color: #A52A2A; font-weight: bold;">use</span> <span style="color: #2F8B58; font-weight: bold;">Libs</span>\<span style="color: #F5666D;">View</span>;
|
||||
|
||||
<span style="color: #A52A2A; font-weight: bold;">class</span> <span style="color: #2F8B58; font-weight: bold;">NoteController</span> {
|
||||
<span style="color: #A52A2A; font-weight: bold;">public</span> <span style="color: #A52A2A; font-weight: bold;">static</span> <span style="color: #A52A2A; font-weight: bold;">function</span> <span style="color: #00578E; font-weight: bold;">home</span>(Request $<span style="color: #0084C8; font-weight: bold;">request</span>): <span style="color: #2F8B58; font-weight: bold;">void</span>
|
||||
<span style="color: #A52A2A; font-weight: bold;">public</span> <span style="color: #A52A2A; font-weight: bold;">static</span> <span style="color: #A52A2A; font-weight: bold;">function</span> <span style="color: #00578E; font-weight: bold;">home</span>(<span style="color: #2F8B58; font-weight: bold;">Request</span> $<span style="color: #0084C8; font-weight: bold;">request</span>): <span style="color: #2F8B58; font-weight: bold;">void</span>
|
||||
{
|
||||
<span style="color: #F5666D;">View</span>::render(<span style="color: #4E9A06;">'CreateNote'</span>);
|
||||
}
|
||||
@ -957,7 +949,7 @@ Aquí me doy el lujo de hacer otro paréntesis para hablar del tipo <code>callab
|
||||
|
||||
<div class="org-src-container">
|
||||
<pre class="src src-php"><span style="color: #A020F0;"><?php</span>
|
||||
<span style="color: #A52A2A; font-weight: bold;">use</span> <span style="color: #2F8B58; font-weight: bold;">Libs\Router</span>;
|
||||
<span style="color: #A52A2A; font-weight: bold;">use</span> <span style="color: #2F8B58; font-weight: bold;">Libs</span>\<span style="color: #F5666D;">Router</span>;
|
||||
|
||||
<span style="color: #F5666D;">Router</span>::get(<span style="color: #4E9A06;">'/'</span>, <span style="color: #4E9A06;">'Controllers\NoteController::home'</span>);
|
||||
</pre>
|
||||
@ -969,10 +961,10 @@ O de esta otra manera:
|
||||
|
||||
<div class="org-src-container">
|
||||
<pre class="src src-php"><span style="color: #A020F0;"><?php</span>
|
||||
<span style="color: #A52A2A; font-weight: bold;">use</span> <span style="color: #2F8B58; font-weight: bold;">Controllers\NoteController</span>;
|
||||
<span style="color: #A52A2A; font-weight: bold;">use</span> <span style="color: #2F8B58; font-weight: bold;">Libs\Router</span>;
|
||||
<span style="color: #A52A2A; font-weight: bold;">use</span> <span style="color: #2F8B58; font-weight: bold;">Controllers</span>\<span style="color: #F5666D;">NoteController</span>;
|
||||
<span style="color: #A52A2A; font-weight: bold;">use</span> <span style="color: #2F8B58; font-weight: bold;">Libs</span>\<span style="color: #F5666D;">Router</span>;
|
||||
|
||||
<span style="color: #F5666D;">Router</span>::get(<span style="color: #4E9A06;">'/'</span>, [<span style="color: #F5666D;">NoteController</span>::<span style="color: #A020F0;">class</span>, <span style="color: #4E9A06;">'home'</span>]);
|
||||
<span style="color: #F5666D;">Router</span>::get(<span style="color: #4E9A06;">'/'</span>, [<span style="color: #F5666D;">NoteController</span>::<span style="color: #F5666D;">class</span>, <span style="color: #4E9A06;">'home'</span>]);
|
||||
</pre>
|
||||
</div>
|
||||
|
||||
@ -980,8 +972,8 @@ O de esta otra manera:
|
||||
Ambas funcionarán y al entrar en <code>http://localhost</code> ya
|
||||
</p>
|
||||
</div>
|
||||
<div id="outline-container-orgdfd194e" class="outline-4">
|
||||
<h4 id="orgdfd194e"><span class="section-number-4">3.5.1.</span> Extra: Explicación del tipo callable</h4>
|
||||
<div id="outline-container-orgd364a7e" class="outline-4">
|
||||
<h4 id="orgd364a7e"><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">
|
||||
<p>
|
||||
Enlos anteriores 2 bloques de código lo que hemos visto han sido 2 maneras de escribir un callable:
|
||||
@ -993,12 +985,12 @@ En el primer código he escrito el nombre completo hasta la función en un strin
|
||||
|
||||
<div class="org-src-container">
|
||||
<pre class="src src-php"><span style="color: #A020F0;"><?php</span>
|
||||
<span style="color: #A52A2A; font-weight: bold;">use</span> <span style="color: #2F8B58; font-weight: bold;">Controllers\NoteController</span>;
|
||||
<span style="color: #A52A2A; font-weight: bold;">use</span> <span style="color: #2F8B58; font-weight: bold;">Libs\Request</span>;
|
||||
<span style="color: #A52A2A; font-weight: bold;">use</span> <span style="color: #2F8B58; font-weight: bold;">Libs\Router</span>;
|
||||
<span style="color: #A52A2A; font-weight: bold;">use</span> <span style="color: #2F8B58; font-weight: bold;">Controllers</span>\<span style="color: #F5666D;">NoteController</span>;
|
||||
<span style="color: #A52A2A; font-weight: bold;">use</span> <span style="color: #2F8B58; font-weight: bold;">Libs</span>\<span style="color: #F5666D;">Request</span>;
|
||||
<span style="color: #A52A2A; font-weight: bold;">use</span> <span style="color: #2F8B58; font-weight: bold;">Libs</span>\<span style="color: #F5666D;">Router</span>;
|
||||
|
||||
<span style="color: #F5666D;">Router</span>::get(<span style="color: #4E9A06;">'/'</span>, <span style="color: #A52A2A; font-weight: bold;">function</span>(){});
|
||||
[<span style="color: #F5666D;">NoteController</span>::<span style="color: #A020F0;">class</span>, <span style="color: #4E9A06;">'home'</span>](<span style="color: #A52A2A; font-weight: bold;">new</span> <span style="color: #2F8B58; font-weight: bold;">Request</span>);
|
||||
[<span style="color: #F5666D;">NoteController</span>::<span style="color: #F5666D;">class</span>, <span style="color: #4E9A06;">'home'</span>](<span style="color: #A52A2A; font-weight: bold;">new</span> <span style="color: #2F8B58; font-weight: bold;">Request</span>);
|
||||
</pre>
|
||||
</div>
|
||||
|
||||
@ -1008,8 +1000,8 @@ O también:
|
||||
|
||||
<div class="org-src-container">
|
||||
<pre class="src src-php"><span style="color: #A020F0;"><?php</span>
|
||||
<span style="color: #A52A2A; font-weight: bold;">use</span> <span style="color: #2F8B58; font-weight: bold;">Libs\Request</span>;
|
||||
<span style="color: #A52A2A; font-weight: bold;">use</span> <span style="color: #2F8B58; font-weight: bold;">Libs\Router</span>;
|
||||
<span style="color: #A52A2A; font-weight: bold;">use</span> <span style="color: #2F8B58; font-weight: bold;">Libs</span>\<span style="color: #F5666D;">Request</span>;
|
||||
<span style="color: #A52A2A; font-weight: bold;">use</span> <span style="color: #2F8B58; font-weight: bold;">Libs</span>\<span style="color: #F5666D;">Router</span>;
|
||||
|
||||
<span style="color: #F5666D;">Router</span>::get(<span style="color: #4E9A06;">'/'</span>, <span style="color: #A52A2A; font-weight: bold;">function</span>(){});
|
||||
<span style="color: #4E9A06;">'Controllers\NoteController::home'</span>(<span style="color: #A52A2A; font-weight: bold;">new</span> <span style="color: #2F8B58; font-weight: bold;">Request</span>);
|
||||
@ -1022,34 +1014,34 @@ Sé que esto es algo raro y que realmente tiene que ver con el conocimiendo de P
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
<div id="outline-container-orgc3939ab" class="outline-3">
|
||||
<h3 id="orgc3939ab"><span class="section-number-3">3.6.</span> Creando la nota encriptada</h3>
|
||||
<div id="outline-container-org52c1f9d" class="outline-3">
|
||||
<h3 id="org52c1f9d"><span class="section-number-3">3.6.</span> Creando la nota encriptada</h3>
|
||||
<div class="outline-text-3" id="text-3-6">
|
||||
<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:
|
||||
</p>
|
||||
|
||||
<div class="org-src-container">
|
||||
<pre class="src src-php"><span style="color: #A52A2A; font-weight: bold;">public</span> <span style="color: #A52A2A; font-weight: bold;">function</span> <span style="color: #00578E; font-weight: bold;">encrypt</span>(): <span style="color: #2F8B58; font-weight: bold;">string</span>
|
||||
{
|
||||
<span style="color: #204A87;">// </span><span style="color: #204A87;">Generamos una llave aleatoria de entre 12 a 32 caracteres</span>
|
||||
$<span style="color: #0084C8; font-weight: bold;">secretKey</span> = substr(
|
||||
str_shuffle(<span style="color: #4E9A06;">'0123456789abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ'</span>),
|
||||
0,
|
||||
mt_rand(16, 32)
|
||||
<pre class="src src-php"><span style="color: #204A87;">public function encrypt(): string</span>
|
||||
<span style="color: #204A87;">{</span>
|
||||
<span style="color: #204A87;"> // Generamos una llave aleatoria de entre 12 a 32 caracteres</span>
|
||||
<span style="color: #204A87;"> $secretKey = substr(</span>
|
||||
<span style="color: #204A87;"> str_shuffle('0123456789abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ'),</span>
|
||||
<span style="color: #204A87;"> 0,</span>
|
||||
<span style="color: #204A87;"> mt_rand(16, 32)</span>
|
||||
<span style="color: #204A87;"> );</span>
|
||||
|
||||
<span style="color: #204A87;"> // Encriptamos la nota en AES256 usando la llave antes generada</span>
|
||||
<span style="color: #204A87;"> $this-</span>>content = openssl_encrypt(
|
||||
$this->content,
|
||||
'AES-256-CBC',
|
||||
$secretKey,
|
||||
OPENSSL_RAW_DATA,
|
||||
substr($secretKey, 0, 16)
|
||||
);
|
||||
|
||||
<span style="color: #204A87;">// </span><span style="color: #204A87;">Encriptamos la nota en AES256 usando la llave antes generada</span>
|
||||
<span style="color: #F5666D;">$</span><span style="color: #F5666D;">this</span>-><span style="color: #0084C8; font-weight: bold;">content</span> = openssl_encrypt(
|
||||
<span style="color: #F5666D;">$</span><span style="color: #F5666D;">this</span>-><span style="color: #0084C8; font-weight: bold;">content</span>,
|
||||
<span style="color: #4E9A06;">'AES-256-CBC'</span>,
|
||||
$<span style="color: #0084C8; font-weight: bold;">secretKey</span>,
|
||||
<span style="color: #F5666D;">OPENSSL_RAW_DATA</span>,
|
||||
substr($<span style="color: #0084C8; font-weight: bold;">secretKey</span>, 0, 16)
|
||||
);
|
||||
|
||||
<span style="color: #204A87;">// </span><span style="color: #204A87;">Devolvemos la llave</span>
|
||||
<span style="color: #A52A2A; font-weight: bold;">return</span> $<span style="color: #0084C8; font-weight: bold;">secretKey</span>;
|
||||
// Devolvemos la llave
|
||||
return $secretKey;
|
||||
}
|
||||
</pre>
|
||||
</div>
|
||||
@ -1063,20 +1055,20 @@ Ahora vamos a hacer un controlador que recibirá el formulario, encriptará la n
|
||||
</p>
|
||||
|
||||
<div class="org-src-container">
|
||||
<pre class="src src-php"><span style="color: #A52A2A; font-weight: bold;">public</span> <span style="color: #A52A2A; font-weight: bold;">static</span> <span style="color: #A52A2A; font-weight: bold;">function</span> <span style="color: #00578E; font-weight: bold;">create</span>(Request $<span style="color: #0084C8; font-weight: bold;">request</span>): <span style="color: #2F8B58; font-weight: bold;">void</span>
|
||||
{
|
||||
<span style="color: #204A87;">// </span><span style="color: #204A87;">Creamos una instancia de Note y le pasamos los datos del formulario</span>
|
||||
$<span style="color: #0084C8; font-weight: bold;">note</span> = <span style="color: #A52A2A; font-weight: bold;">new</span> <span style="color: #2F8B58; font-weight: bold;">Note</span>;
|
||||
$<span style="color: #0084C8; font-weight: bold;">note</span>-><span style="color: #0084C8; font-weight: bold;">content</span> = $<span style="color: #0084C8; font-weight: bold;">request</span>-><span style="color: #0084C8; font-weight: bold;">post</span>-><span style="color: #0084C8; font-weight: bold;">note</span>;
|
||||
$<span style="color: #0084C8; font-weight: bold;">note</span>-><span style="color: #0084C8; font-weight: bold;">max_views</span> = $<span style="color: #0084C8; font-weight: bold;">request</span>-><span style="color: #0084C8; font-weight: bold;">post</span>-><span style="color: #0084C8; font-weight: bold;">max_views</span>;
|
||||
$<span style="color: #0084C8; font-weight: bold;">note</span>-><span style="color: #0084C8; font-weight: bold;">expire_at</span> = strtotime(<span style="color: #4E9A06;">"+</span><span style="color: #0084C8; font-weight: bold;">{$request->post->expiration}</span><span style="color: #4E9A06;"> minutes"</span>);
|
||||
<pre class="src src-php"><span style="color: #204A87;">public static function create(Request $request): void</span>
|
||||
<span style="color: #204A87;">{</span>
|
||||
<span style="color: #204A87;"> // Creamos una instancia de Note y le pasamos los datos del formulario</span>
|
||||
<span style="color: #204A87;"> $note = new Note;</span>
|
||||
<span style="color: #204A87;"> $note-</span>>content = $request->post->note;
|
||||
$note->max_views = $request->post->max_views;
|
||||
$note->expire_at = strtotime("+{$request->post->expiration} minutes");
|
||||
|
||||
<span style="color: #204A87;">// </span><span style="color: #204A87;">Encriptamos los datos y luego los guardamos</span>
|
||||
$<span style="color: #0084C8; font-weight: bold;">secretKey</span> = $<span style="color: #0084C8; font-weight: bold;">note</span>->encrypt();
|
||||
$<span style="color: #0084C8; font-weight: bold;">note</span>->save();
|
||||
// Encriptamos los datos y luego los guardamos
|
||||
$secretKey = $note->encrypt();
|
||||
$note->save();
|
||||
|
||||
<span style="color: #204A87;">// </span><span style="color: #204A87;">Redirigimos a la url final donde se verá la nota</span>
|
||||
<span style="color: #F5666D;">Router</span>::redirect(<span style="color: #4E9A06;">"/</span><span style="color: #0084C8; font-weight: bold;">{$note->id}</span><span style="color: #4E9A06;">/</span><span style="color: #0084C8; font-weight: bold;">{$secretKey}</span><span style="color: #4E9A06;">"</span>);
|
||||
// Redirigimos a la url final donde se verá la nota
|
||||
Router::redirect("/{$note->id}/{$secretKey}");
|
||||
}
|
||||
</pre>
|
||||
</div>
|
||||
@ -1086,8 +1078,8 @@ Desde luego, también tenemos que añadir los uses de <code>Libs\Router</code> y
|
||||
</p>
|
||||
|
||||
<div class="org-src-container">
|
||||
<pre class="src src-php"><span style="color: #A52A2A; font-weight: bold;">use</span> <span style="color: #2F8B58; font-weight: bold;">Libs\Router</span>;
|
||||
<span style="color: #A52A2A; font-weight: bold;">use</span> <span style="color: #2F8B58; font-weight: bold;">Models\Note</span>;
|
||||
<pre class="src src-php"><span style="color: #204A87;">use Libs\Router;</span>
|
||||
<span style="color: #204A87;">use Models\Note;</span>
|
||||
</pre>
|
||||
</div>
|
||||
|
||||
@ -1100,7 +1092,7 @@ Para finalizar vamos configurar la ruta. Así que editamos el archivo <code>note
|
||||
</p>
|
||||
|
||||
<div class="org-src-container">
|
||||
<pre class="src src-php"><span style="color: #F5666D;">Router</span>::post(<span style="color: #4E9A06;">'/'</span>, [<span style="color: #F5666D;">NoteController</span>::<span style="color: #A020F0;">class</span>, <span style="color: #4E9A06;">'create'</span>]);
|
||||
<pre class="src src-php"><span style="color: #204A87;">Router::post('/', [NoteController::class, 'create']);</span>
|
||||
</pre>
|
||||
</div>
|
||||
|
||||
@ -1113,57 +1105,57 @@ Ahora ya podemos comenzar a crear nuestras notas, auque aún no las podremos ver
|
||||
</p>
|
||||
</div>
|
||||
</div>
|
||||
<div id="outline-container-org6e0596b" class="outline-3">
|
||||
<h3 id="org6e0596b"><span class="section-number-3">3.7.</span> Recta final: Desencriptando y mostrando las notas</h3>
|
||||
<div id="outline-container-org37189ac" class="outline-3">
|
||||
<h3 id="org37189ac"><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">
|
||||
<p>
|
||||
Vamos directo al grano, editaremos el modelo (<code>src/Models/Note.php</code>) y le añadiremos esta otra función para desencriptar:
|
||||
</p>
|
||||
|
||||
<div class="org-src-container">
|
||||
<pre class="src src-php"><span style="color: #A52A2A; font-weight: bold;">public</span> <span style="color: #A52A2A; font-weight: bold;">function</span> <span style="color: #00578E; font-weight: bold;">decrypt</span>(<span style="color: #2F8B58; font-weight: bold;">string</span> $<span style="color: #0084C8; font-weight: bold;">secretKey</span>) : <span style="color: #2F8B58; font-weight: bold;">void</span>
|
||||
{
|
||||
<span style="color: #204A87;">// </span><span style="color: #204A87;">Verificamos si la nota ha expirado</span>
|
||||
<span style="color: #A52A2A; font-weight: bold;">if</span> (<span style="color: #F5666D;">$</span><span style="color: #F5666D;">this</span>-><span style="color: #0084C8; font-weight: bold;">expire_at</span> < time()) {
|
||||
<span style="color: #F5666D;">$</span><span style="color: #F5666D;">this</span>-><span style="color: #0084C8; font-weight: bold;">content</span> = <span style="color: #4E9A06;">'La nota se ha destruido por expiración.'</span>;
|
||||
<span style="color: #F5666D;">$</span><span style="color: #F5666D;">this</span>->delete();
|
||||
<span style="color: #A52A2A; font-weight: bold;">return</span>;
|
||||
<pre class="src src-php"><span style="color: #204A87;">public function decrypt(string $secretKey) : void</span>
|
||||
<span style="color: #204A87;">{</span>
|
||||
<span style="color: #204A87;"> // Verificamos si la nota ha expirado</span>
|
||||
<span style="color: #204A87;"> if ($this-</span>>expire_at < <span style="color: #00578E; font-weight: bold;">time</span>()) {
|
||||
$this->content = 'La nota se ha destruido por expiración.';
|
||||
$this->delete();
|
||||
return;
|
||||
}
|
||||
|
||||
<span style="color: #204A87;">// </span><span style="color: #204A87;">Intentamos desencriptar.</span>
|
||||
$<span style="color: #0084C8; font-weight: bold;">content</span> = openssl_decrypt(
|
||||
<span style="color: #F5666D;">$</span><span style="color: #F5666D;">this</span>-><span style="color: #0084C8; font-weight: bold;">content</span>,
|
||||
<span style="color: #4E9A06;">'AES-256-CBC'</span>,
|
||||
$<span style="color: #0084C8; font-weight: bold;">secretKey</span>,
|
||||
<span style="color: #F5666D;">OPENSSL_RAW_DATA</span>,
|
||||
substr($<span style="color: #0084C8; font-weight: bold;">secretKey</span>, 0, 16)
|
||||
// Intentamos desencriptar.
|
||||
$content = openssl_decrypt(
|
||||
$this->content,
|
||||
'AES-256-CBC',
|
||||
$secretKey,
|
||||
OPENSSL_RAW_DATA,
|
||||
substr($secretKey, 0, 16)
|
||||
);
|
||||
|
||||
<span style="color: #204A87;">// </span><span style="color: #204A87;">Verificamos si desencriptó correctamente</span>
|
||||
<span style="color: #A52A2A; font-weight: bold;">if</span> (is_string($<span style="color: #0084C8; font-weight: bold;">content</span>)) {
|
||||
// Verificamos si desencriptó correctamente
|
||||
if (is_string($content)) {
|
||||
|
||||
<span style="color: #204A87;">// </span><span style="color: #204A87;">Verificamos si está configurado para infinitas vistas.</span>
|
||||
<span style="color: #A52A2A; font-weight: bold;">if</span> (<span style="color: #F5666D;">$</span><span style="color: #F5666D;">this</span>-><span style="color: #0084C8; font-weight: bold;">max_views</span> == 0) {
|
||||
<span style="color: #F5666D;">$</span><span style="color: #F5666D;">this</span>-><span style="color: #0084C8; font-weight: bold;">content</span> = $<span style="color: #0084C8; font-weight: bold;">content</span>;
|
||||
<span style="color: #A52A2A; font-weight: bold;">return</span>;
|
||||
// Verificamos si está configurado para infinitas vistas.
|
||||
if ($this->max_views == 0) {
|
||||
$this->content = $content;
|
||||
return;
|
||||
}
|
||||
|
||||
<span style="color: #204A87;">// </span><span style="color: #204A87;">Reducimos el contador de vistas</span>
|
||||
<span style="color: #F5666D;">$</span><span style="color: #F5666D;">this</span>-><span style="color: #0084C8; font-weight: bold;">max_views</span> = <span style="color: #F5666D;">$</span><span style="color: #F5666D;">this</span>-><span style="color: #0084C8; font-weight: bold;">max_views</span> - 1;
|
||||
<span style="color: #F5666D;">$</span><span style="color: #F5666D;">this</span>->save();
|
||||
// Reducimos el contador de vistas
|
||||
$this->max_views = $this->max_views - 1;
|
||||
$this->save();
|
||||
|
||||
<span style="color: #204A87;">// </span><span style="color: #204A87;">Verificamos si el contador de vistas ha llegado a 0.</span>
|
||||
<span style="color: #A52A2A; font-weight: bold;">if</span> (<span style="color: #F5666D;">$</span><span style="color: #F5666D;">this</span>-><span style="color: #0084C8; font-weight: bold;">max_views</span> <= 0) {
|
||||
<span style="color: #F5666D;">$</span><span style="color: #F5666D;">this</span>-><span style="color: #0084C8; font-weight: bold;">content</span> = <span style="color: #4E9A06;">'La nota se ha destruido según su límite de vistas.'</span>;
|
||||
<span style="color: #F5666D;">$</span><span style="color: #F5666D;">this</span>->delete();
|
||||
<span style="color: #A52A2A; font-weight: bold;">return</span>;
|
||||
// Verificamos si el contador de vistas ha llegado a 0.
|
||||
if ($this->max_views <= 0) {
|
||||
$this->content = 'La nota se ha destruido según su límite de vistas.';
|
||||
$this->delete();
|
||||
return;
|
||||
}
|
||||
|
||||
<span style="color: #204A87;">// </span><span style="color: #204A87;">Si no ha expirado, solo devolvemos el contenido</span>
|
||||
<span style="color: #F5666D;">$</span><span style="color: #F5666D;">this</span>-><span style="color: #0084C8; font-weight: bold;">content</span> = $<span style="color: #0084C8; font-weight: bold;">content</span>;
|
||||
} <span style="color: #A52A2A; font-weight: bold;">else</span> {
|
||||
<span style="color: #204A87;">// </span><span style="color: #204A87;">Si no se pudo desencriptar colocamos un error</span>
|
||||
<span style="color: #F5666D;">$</span><span style="color: #F5666D;">this</span>-><span style="color: #0084C8; font-weight: bold;">content</span> = <span style="color: #4E9A06;">'Llave incorrecta.'</span>;
|
||||
// Si no ha expirado, solo devolvemos el contenido
|
||||
$this->content = $content;
|
||||
} else {
|
||||
// Si no se pudo desencriptar colocamos un error
|
||||
$this->content = 'Llave incorrecta.';
|
||||
}
|
||||
|
||||
}
|
||||
@ -1175,29 +1167,29 @@ Ahora en el <code>NoteController</code> añadiremos esta otra función:
|
||||
</p>
|
||||
|
||||
<div class="org-src-container">
|
||||
<pre class="src src-php"><span style="color: #A52A2A; font-weight: bold;">public</span> <span style="color: #A52A2A; font-weight: bold;">static</span> <span style="color: #A52A2A; font-weight: bold;">function</span> <span style="color: #00578E; font-weight: bold;">show</span>(Request $<span style="color: #0084C8; font-weight: bold;">request</span>): <span style="color: #2F8B58; font-weight: bold;">void</span>
|
||||
{
|
||||
<span style="color: #204A87;">// </span><span style="color: #204A87;">Verificamos si el ID es un número</span>
|
||||
<span style="color: #A52A2A; font-weight: bold;">if</span> (!is_numeric($<span style="color: #0084C8; font-weight: bold;">request</span>-><span style="color: #0084C8; font-weight: bold;">params</span>-><span style="color: #0084C8; font-weight: bold;">id</span>)) {
|
||||
<span style="color: #F5666D;">Router</span>::defaultNotFound();
|
||||
<span style="color: #A52A2A; font-weight: bold;">return</span>;
|
||||
<pre class="src src-php"><span style="color: #204A87;">public static function show(Request $request): void</span>
|
||||
<span style="color: #204A87;">{</span>
|
||||
<span style="color: #204A87;"> // Verificamos si el ID es un número</span>
|
||||
<span style="color: #204A87;"> if (!is_numeric($request-</span>>params->id)) {
|
||||
Router::defaultNotFound();
|
||||
return;
|
||||
}
|
||||
|
||||
<span style="color: #204A87;">// </span><span style="color: #204A87;">Obtenemos la nota de la base de datos</span>
|
||||
$<span style="color: #0084C8; font-weight: bold;">note</span> = <span style="color: #F5666D;">Note</span>::getById($<span style="color: #0084C8; font-weight: bold;">request</span>-><span style="color: #0084C8; font-weight: bold;">params</span>-><span style="color: #0084C8; font-weight: bold;">id</span>);
|
||||
// Obtenemos la nota de la base de datos
|
||||
$note = Note::getById($request->params->id);
|
||||
|
||||
<span style="color: #204A87;">// </span><span style="color: #204A87;">Verificamos si la nota existe</span>
|
||||
<span style="color: #A52A2A; font-weight: bold;">if</span> (is_null($<span style="color: #0084C8; font-weight: bold;">note</span>)) {
|
||||
<span style="color: #F5666D;">Router</span>::defaultNotFound();
|
||||
<span style="color: #A52A2A; font-weight: bold;">return</span>;
|
||||
// Verificamos si la nota existe
|
||||
if (is_null($note)) {
|
||||
Router::defaultNotFound();
|
||||
return;
|
||||
}
|
||||
|
||||
<span style="color: #204A87;">// </span><span style="color: #204A87;">Desencriptamos la nota</span>
|
||||
$<span style="color: #0084C8; font-weight: bold;">note</span>->decrypt($<span style="color: #0084C8; font-weight: bold;">request</span>-><span style="color: #0084C8; font-weight: bold;">params</span>-><span style="color: #0084C8; font-weight: bold;">key</span>);
|
||||
// Desencriptamos la nota
|
||||
$note->decrypt($request->params->key);
|
||||
|
||||
<span style="color: #204A87;">// </span><span style="color: #204A87;">Imprimimos en formato de texto plano el resultado del desencriptado</span>
|
||||
$<span style="color: #0084C8; font-weight: bold;">view</span> = <span style="color: #A52A2A; font-weight: bold;">new</span> <span style="color: #2F8B58; font-weight: bold;">View</span>;
|
||||
$<span style="color: #0084C8; font-weight: bold;">view</span>->text($<span style="color: #0084C8; font-weight: bold;">note</span>-><span style="color: #0084C8; font-weight: bold;">content</span>);
|
||||
// Imprimimos en formato de texto plano el resultado del desencriptado
|
||||
$view = new View;
|
||||
$view->text($note->content);
|
||||
}
|
||||
</pre>
|
||||
</div>
|
||||
@ -1219,7 +1211,7 @@ Ahora la cerecita del paste: Vamos a configurar el router, así que editamos nue
|
||||
</p>
|
||||
|
||||
<div class="org-src-container">
|
||||
<pre class="src src-php"><span style="color: #F5666D;">Router</span>::get(<span style="color: #4E9A06;">'/{id}/{key}'</span>, [<span style="color: #F5666D;">NoteController</span>::<span style="color: #A020F0;">class</span>, <span style="color: #4E9A06;">'show'</span>]);
|
||||
<pre class="src src-php"><span style="color: #204A87;">Router::get('/{id}/{key}', [NoteController::class, 'show']);</span>
|
||||
</pre>
|
||||
</div>
|
||||
|
||||
@ -1252,8 +1244,8 @@ Crea una aplicación de gestión tareas (un TODO list), en donde puedas agregar
|
||||
</p>
|
||||
</div>
|
||||
</div>
|
||||
<div id="outline-container-org55ccc03" class="outline-3">
|
||||
<h3 id="org55ccc03"><span class="section-number-3">3.8.</span> Repositorio</h3>
|
||||
<div id="outline-container-org471f476" class="outline-3">
|
||||
<h3 id="org471f476"><span class="section-number-3">3.8.</span> Repositorio</h3>
|
||||
<div class="outline-text-3" id="text-3-8">
|
||||
<p>
|
||||
Por si alguien se perdió o sencillamente quiere ver código, he subido la aplicación ignota en este repositorio:
|
||||
@ -1269,8 +1261,8 @@ Te animo a hacerle un fork, mejorarlo y enviármelo. Los forks que me parezcan i
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
<div id="outline-container-org6cba074" class="outline-2">
|
||||
<h2 id="org6cba074"><span class="section-number-2">4.</span> Contacto</h2>
|
||||
<div id="outline-container-orgefeb2e7" class="outline-2">
|
||||
<h2 id="orgefeb2e7"><span class="section-number-2">4.</span> Contacto</h2>
|
||||
<div class="outline-text-2" id="text-4">
|
||||
<p>
|
||||
Como siempre, pueden contactarme mediante el correo <code>webmaster@outcontol.net</code>
|
||||
@ -1288,7 +1280,7 @@ No es una comunidad de programación solamente, pero ahora mismo no existe una d
|
||||
</div>
|
||||
<div id="postamble" class="status">
|
||||
<p class="author">Author: KJ</p>
|
||||
<p class="date">Created: 2024-09-06 vie 22:27</p>
|
||||
<p class="date">Created: 2024-09-24 mar 10:27</p>
|
||||
<p class="validation"><a href="https://validator.w3.org/check?uri=referer">Validate</a></p>
|
||||
</div>
|
||||
</body>
|
||||
|
||||
@ -5,11 +5,9 @@
|
||||
|
||||
* Introducción
|
||||
|
||||
[[https://git.kj2.me/kj/duckbrain][Duckbrain]] es un conjunto de librerías creadas especialmente pensando en hacer algo simple, que cualquiera pueda deshacer y rearmar fácilmente.
|
||||
[[https://git.kj2.me/kj/duckbrain][Duckbrain]] es un conjunto de librerías diseñado para hacer algo simple que cualquiera puede deshacer y rearmar fácilmente. Gracias a su versatilidad, puedes usarlo en cualquier proyecto, pero ten en cuenta que a medida que el proyecto sea más grande, también lo será la ingeniería necesaria de tu parte para adaptarlo a los requisitos.
|
||||
|
||||
Gracias a esa versatilidad, puedes usarlo cualquier proyecto, pero 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.
|
||||
|
||||
Otro punto fuerte que puedo dar de esta herramienta, es que te puede ser tremendamente útil si estás comenzando, ya que al ser tan pequeño y modificable, es más sencillo que lo comprendas y esto más adelante te ayudará a comprender cosas más grandes.
|
||||
Otro punto a tener en cuenta es que Duckbrain puede ser muy útil si estás comenzando, ya que su pequeñez y modficabilidad hacen que sea más fácil de comprender y, a medida que avances, te ayudará a entender cosas más grandes.
|
||||
|
||||
** Estructura de archivos de Duckbrain
|
||||
|
||||
@ -36,7 +34,7 @@ Al entrar a la carpeta de Duckbrain encontrarás esta estructura de archivos (ig
|
||||
└── Views
|
||||
#+end_src
|
||||
|
||||
Primero veamos las carpetas y luego los archivos:
|
||||
Primero, observemos las carpetas y luego los archivos:
|
||||
|
||||
*** Carpeta src
|
||||
|
||||
@ -44,17 +42,15 @@ En esta carpeta se encuentra todo el código PHP de lo que será nuestro proyect
|
||||
|
||||
*** Carpetas: Controllers, Libs, Models, Middlewares, Views y Routers
|
||||
|
||||
Si sabes de estructuras de diseño, ya te debe quedar claro qué va en cada una de estas carpetas, puesto que en el nombre de las mismas lo indica.
|
||||
Si sabes de estructuras de diseño de software, ya entenderás qué va en cada una de estas carpetas. Si no, es momento de investigar por lo menos lo que significa la arquitectura MVC, ya que es una arquitectura simple bastante común y lo que usaremos en este manual.
|
||||
|
||||
Si no sabes que es un Model, un Middleware, Controller, etc. entonces requieres buscar ahora mismo lo que es una arquitectura de diseño de software y leerte al menos en qué consiste la arquitectura de MVC, ya que es una arquitectura simple y la que usaremos más adelante en este manual. Si lo comprendes, solo sigue leyendo.
|
||||
Al igual que con la carpeta =src=, puedes cambiar y organizar las carpetas según tus necesidades. Solo ten cuidado de modificar los archivos asociados a las carpetas Views y Router, ya que afectarían al archivo =src/Libs/View.php= y el archivo =index.php=, respectivamente. En todo caso, mejor no hagas cambios en las rutas carpetas antes de completar po lo menos la sección [[Mi primera aplicación][Mi primera aplicación]].
|
||||
|
||||
Al igual que con la carpeta =src=, 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 =Views= y =Router= que se editarían en el archivo =src/Libs/View.php= y el archivo =index.php= 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 [[Mi primera aplicación][Mi primera aplicación]] 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.
|
||||
|
||||
Desde luego, si eres un ansias y ya has programado antes en alguna arquitectura de diseño como DDD, MVC, TDD, EDD, etc. y manejas decentemente PHP, con que te leas el código del archivo =index.php= (son solo 20 líneas de código) te deberá bastar y puedes saltarte el resto del este manual y guiarte de ahora en adelante con la documentación de los comentarios (docblocks) de las librerías.
|
||||
Si eres un ansias y ya has programado antes en alguna arquitectura de diseño como DDD, MVC, TDD, EDD, etc. y manejas decentemente PHP, con que te leas el código del archivo =index.php= (son solo 20 líneas de código) te deberá bastar y puedes saltarte el resto del este manual y guiarte de ahora en adelante con la documentación de los comentarios (docblocks) de las librerías.
|
||||
|
||||
*** Los archivos en la raíz
|
||||
|
||||
El =.htaccess= es un archivo que te será útil si usas apache o algún otro servidor web que use estos archivos. Contiene una configuración especial para que funcionen las *rutas virtuales*, o sea, para que podamos crear una ruta tipo =mitsitio.com/mi-ruta-virtual/= a pesar de que la carpeta =mi-ruta-virtual= no exista.
|
||||
El =.htaccess= es un archivo que te será útil si usas [[https://httpd.apache.org/][Apache]] o algún otro servidor similar. Contiene una configuración especial para que funcionen las *rutas virtuales*, o sea, para que podamos crear una ruta tipo =misitio.com/mi-ruta-virtual/= a pesar de que la carpeta =mi-ruta-virtual= no exista.
|
||||
|
||||
En caso de que uses nginx, debes configurar el webserver con la regla equivalente al contenido del archivo =.htaccess= que sería más o menos esto:
|
||||
|
||||
@ -64,13 +60,13 @@ location / {
|
||||
}
|
||||
#+end_src
|
||||
|
||||
El archivo =index.php= es el punto de entrada de nuestra aplicación, aquí sucederá toda la magia inicial y sólo requiere de 20 míseras lineas para hacer ese gran trabajo y soportar sistemas tan grandes sin despeinarse ante frameworks más complejos como laravel o que son usados por cientos de miles de usuarios en cientos de instalaciones. Esto lo menciono no por creer que ttps://git.kj2.me/kj/duckbrain][Duckbrain podría soportarlo, sino porque es algo que ya sucede, o sea, dichos sistemas ya existen: Los he hecho yo o he estado involucrado en parte del proyecto al punto de poder elegir [[https://git.kj2.me/kj/duckbrain][Duckbrain]] como base para el mismo.
|
||||
El archivo =index.php= es el punto de entrada de nuestra aplicación, aquí sucederá toda la magia inicial y sólo requiere de 20 míseras lineas para hacer ese gran trabajo y soportar sistemas tan grandes sin despeinarse.
|
||||
|
||||
El archivo =config.php=, como su nombre indica, es el archivo para colocar las configuraciones.
|
||||
|
||||
*** Los archivos en la carpeta Libs
|
||||
|
||||
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.
|
||||
Los archivos en la carpeta "Libs" son principalmente librerías. Cada archivo tiene un nombre descriptivo que indica su función. Si tienes conocimientos básicos sobre diseño y lees los nombres de estas librerías, deberías poder comprender lo que hacen. Si no lo entiendes con solo eso, sigue leyendo el manual que hablaremos de casi todas poco a poco.
|
||||
|
||||
** Comprendiendo el arranque del sistema
|
||||
|
||||
@ -296,7 +292,7 @@ define('DB_PASS', '');
|
||||
//define('SITE_URL', '');
|
||||
|
||||
define('ROOT_DIR', __DIR__);
|
||||
?>
|
||||
define('ROOT_CORE', ROOT_DIR.'/src');
|
||||
#+end_src
|
||||
|
||||
La primera línea define el tipo de base de datos que vamos a usar, mientras que el resto su información. Ya que estamos, voy a configurar también SITE_URL que en realida no es necesario, pero quiero hacerlo para dar a notar que en caso de configurarlo, es obligatorio que la url en termine en =/=.
|
||||
@ -314,7 +310,7 @@ define('DB_PASS', '');
|
||||
define('SITE_URL', 'http://localhost/');
|
||||
|
||||
define('ROOT_DIR', __DIR__);
|
||||
?>
|
||||
define('ROOT_CORE', ROOT_DIR.'/src');
|
||||
#+end_src
|
||||
|
||||
Como nuestra base de dato es solo un archivo sqlite, no requerimos de =DB_HOST=, =DB_USER= ni =DB_PASS=. Todas esas líneas podemos eliminarlas o dejarlas tal cual, pues no afectarán en nada.
|
||||
|
||||
Loading…
Reference in New Issue
Block a user