h1,h2,h3,h4,h5,h6,legend{ font-family:"Roboto Slab","ff-tisa-web-pro","Georgia",Arial,sans-serif; font-weight:700; margin-top:0;}h1{ font-size:175%;}.subtitle{ font-size:95%; /* of h1 */}h2{ font-size:150%;}h3{ font-size:125%;}h4{ font-size:115%;}h5{ font-size:110%;}h6{ font-size:100%;}h4,h5,h6{ color:#2980B9; font-weight:300;}html{ -ms-text-size-adjust:100%; -webkit-text-size-adjust:100%; font-size:100%; height:100%; overflow-x:hidden;}body{ background:#edf0f2; color:#404040; font-family:"Lato","proxima-nova","Helvetica Neue",Arial,sans-serif; font-weight:normal; margin:0; min-height:100%; overflow-x:hidden;}#content{ background:#fcfcfc; height:100%; margin-left:300px; /* margin:auto; */ max-width:800px; min-height:100%; padding:1.618em 3.236em;}p{ font-size:16px; line-height:24px; margin:0px 0px 24px 0px;}b,strong{ font-weight:bold}blockquote{ background-color: #F0F0F0; border-left:5px solid #CCCCCC; font-style:italic; line-height:24px; margin:0px 0px 24px 0px; /* margin-left:24px; */ padding: 6px 20px;}ul,ol,dl{ line-height:24px; list-style-image:none; /* list-style:none; */ margin:0px 0px 24px 0px; padding:0;}li{ margin-left: 24px;}dd{ margin:0;}#content .section ul,#content .toctree-wrapper ul,article ul{ list-style:disc; line-height:24px; margin-bottom:24px}#content .section ul li,#content .toctree-wrapper ul li,article ul li{ list-style:disc; margin-left:24px}#content .section ul li p:last-child,#content .toctree-wrapper ul li p:last-child,article ul li p:last-child{ margin-bottom:0}#content .section ul li ul,#content .toctree-wrapper ul li ul,article ul li ul{ margin-bottom:0}#content .section ul li li,#content .toctree-wrapper ul li li,article ul li li{ list-style:circle}#content .section ul li li li,#content .toctree-wrapper ul li li li,article ul li li li{ list-style:square}#content .section ul li ol li,#content .toctree-wrapper ul li ol li,article ul li ol li{ list-style:decimal}#content .section ol,#content ol,article ol{ list-style:decimal; line-height:24px; margin-bottom:24px}#content .section ol li,#content ol li,article ol li{ list-style:decimal; margin-left:24px}#content .section ol li p:last-child,#content ol li p:last-child,article ol li p:last-child{ margin-bottom:0}#content .section ol li ul,#content ol li ul,article ol li ul{ margin-bottom:0}#content .section ol li ul li,#content ol li ul li,article ol li ul li{ list-style:disc}dl dt{ font-weight:bold;}dl p,dl table,dl ul,dl ol{ margin-bottom:12px !important;}dl dd{ margin:0 0 12px 24px;}@media print{ .codeblock,pre.src{ white-space:pre.src-wrap}}@media print{ html,body,section{ background:none !important} *{ box-shadow:none !important; text-shadow:none !important; filter:none !important; -ms-filter:none !important} a,a:visited{ text-decoration:underline} pre.src,blockquote{ page-break-inside:avoid} thead{ display:table-header-group} tr,img{ page-break-inside:avoid} img{ max-width:100% !important} @page{ margin:0.5cm} p,h2,h3{ orphans:3; widows:3} h2,h3{ page-break-after:avoid}}@media print{ #postamble{ display:none} #content{ margin-left:0}}@media print{ #table-of-contents{ display:none} @page{ size: auto; margin: 25mm 25mm 25mm 25mm;} body { margin: 0px;}}@media screen and (max-width: 768px){}@media only screen and (max-width: 480px){}@media screen and (max-width: 768px){ .tablet-hide{ display:none}}@media screen and (max-width: 480px){ .mobile-hide{ display:none}}@media screen and (max
</style>
<scripttype="text/javascript">
/*! jQuery v2.1.3 | (c) 2005, 2014 jQuery Foundation, Inc. | jquery.org/license */!function(a,b){"object"==typeof module&&"object"==typeof module.exports?module.exports=a.document?b(a,!0):function(a){if(!a.document)throw new Error("jQuery requires a window with a document");return b(a)}:b(a)}("undefined"!=typeof window?window:this,function(a,b){var c=[],d=c.slice,e=c.concat,f=c.push,g=c.indexOf,h={},i=h.toString,j=h.hasOwnProperty,k={},l=a.document,m="2.1.3",n=function(a,b){return new n.fn.init(a,b)},o=/^[\s\uFEFF\xA0]+|[\s\uFEFF\xA0]+$/g,p=/^-ms-/,q=/-([\da-z])/gi,r=function(a,b){return b.toUpperCase()};n.fn=n.prototype={jquery:m,constructor:n,selector:"",length:0,toArray:function(){return d.call(this)},get:function(a){return null!=a?0>a?this[a+this.length]:this[a]:d.call(this)},pushStack:function(a){var b=n.merge(this.constructor(),a);return b.prevObject=this,b.context=this.context,b},each:function(a,b){return n.each(this,a,b)},map:function(a){return this.pushStack(n.map(this,function(b,c){return a.call(b,c,b)}))},slice:function(){return this.pushStack(d.apply(this,arguments))},first:function(){return this.eq(0)},last:function(){return this.eq(-1)},eq:function(a){var b=this.length,c=+a+(0>a?b:0);return this.pushStack(c>=0&&b>c?[this[c]]:[])},end:function(){return this.prevObject||this.constructor(null)},push:f,sort:c.sort,splice:c.splice},n.extend=n.fn.extend=function(){var a,b,c,d,e,f,g=arguments[0]||{},h=1,i=arguments.length,j=!1;for("boolean"==typeof g&&(j=g,g=arguments[h]||{},h++),"object"==typeof g||n.isFunction(g)||(g={}),h===i&&(g=this,h--);i>h;h++)if(null!=(a=arguments[h]))for(b in a)c=g[b],d=a[b],g!==d&&(j&&d&&(n.isPlainObject(d)||(e=n.isArray(d)))?(e?(e=!1,f=c&&n.isArray(c)?c:[]):f=c&&n.isPlainObject(c)?c:{},g[b]=n.extend(j,f,d)):void 0!==d&&(g[b]=d));return g},n.extend({expando:"jQuery"+(m+Math.random()).replace(/\D/g,""),isReady:!0,error:function(a){throw new Error(a)},noop:function(){},isFunction:function(a){return"function"===n.type(a)},isArray:Array.isArray,isWindow:function(a){return null!=a&&a===a.window},isNumeric:function(a){return!n.isArray(a)&&a-parseFloat(a)+1>=0},isPlainObject:function(a){return"object"!==n.type(a)||a.nodeType||n.isWindow(a)?!1:a.constructor&&!j.call(a.constructor.prototype,"isPrototypeOf")?!1:!0},isEmptyObject:function(a){var b;for(b in a)return!1;return!0},type:function(a){return null==a?a+"":"object"==typeof a||"function"==typeof a?h[i.call(a)]||"object":typeof a},globalEval:function(a){var b,c=eval;a=n.trim(a),a&&(1===a.indexOf("use strict")?(b=l.createElement("script"),b.text=a,l.head.appendChild(b).parentNode.removeChild(b)):c(a))},camelCase:function(a){return a.replace(p,"ms-").replace(q,r)},nodeName:function(a,b){return a.nodeName&&a.nodeName.toLowerCase()===b.toLowerCase()},each:function(a,b,c){var d,e=0,f=a.length,g=s(a);if(c){if(g){for(;f>e;e++)if(d=b.apply(a[e],c),d===!1)break}else for(e in a)if(d=b.apply(a[e],c),d===!1)break}else if(g){for(;f>e;e++)if(d=b.call(a[e],e,a[e]),d===!1)break}else for(e in a)if(d=b.call(a[e],e,a[e]),d===!1)break;return a},trim:function(a){return null==a?"":(a+"").replace(o,"")},makeArray:function(a,b){var c=b||[];return null!=a&&(s(Object(a))?n.merge(c,"string"==typeof a?[a]:a):f.call(c,a)),c},inArray:function(a,b,c){return null==b?-1:g.call(b,a,c)},merge:function(a,b){for(var c=+b.length,d=0,e=a.length;c>d;d++)a[e++]=b[d];return a.length=e,a},grep:function(a,b,c){for(var d,e=[],f=0,g=a.length,h=!c;g>f;f++)d=!b(a[f],f),d!==h&&e.push(a[f]);return e},map:function(a,b,c){var d,f=0,g=a.length,h=s(a),i=[];if(h)for(;g>f;f++)d=b(a[f],f,c),null!=d&&i.push(d);else for(f in a)d=b(a[f],f,c),null!=d&&i.push(d);return e.apply([],i)},guid:1,proxy:function(a,b){var c,e,f;return"string"==typeof b&&(c=a[b],b=a,a=c),n.isFunction(a)?(e=d.call(arguments,2),f=function(){return a.apply(b||this,e.concat(d.call(arguments)))},f.guid=a.guid=a.guid||n.guid++,f):void 0},now:Date.now,support:k}),n.each("Boolean Number String Function Array Date RegExp Object Error".split(" "),function(a,b){h["[object "+b+"]"]=b.toLowerCase()});function s(a){var b=a.length,c=n.type(a);
<ahref="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.
</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.
Como todo en <ahref="https://git.kj2.me/kj/duckbrain">Duckbrain</a>, esta ruta se puede cambiar editando una variable en el archivo <code>index.php</code>.
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.
</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.
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 <ahref="#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.
Desde luego, si eres un ansias y sabes lo que son las arquitecturas de diseño, ya has programado en alguna arquitectura de diseño como DDD, MVC, TDD, EDD, etc. antes y sabes PHP, con que te leas el código del archivo <code>index.php</code> (son solo 20 líneas de código) y tengas el nivel de PHP para entenderlo y programar en la arquitectura de diseño que desees, entonces con ver esas 20 líneas te deberá bastar y puedes saltarte el resto del este manual y guiarte de ahora en adelante con la documentación API de las librerías o directamente con el LSP de tu editor de código para poco que queda.
</p>
<p>
Para el resto de mortales y gente con menos arrogancia, pueden seguir un ratito más por aquí :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.
</p>
<p>
En caso de que uses nginx, debes configurar el webserver con la regla equivalente al contenido del archivo <code>.htacess</code> que sería más o menos esto:
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 [<ahref="https://git.kj2.me/kj/duckbrain">https://git.kj2.me/kj/duckbrain</a>][Duckbrain]] como base para el mismo.
</p>
<p>
El archivo <code>config.php</code>, como su nombre indica, es el archivo para colocar las configuraciones.
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.
Como la intención de este manual es que comprendas <ahref="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.
</p>
<p>
Como ya mencionamos antes, el archivo <code>.htaccess</code> se encarga de hacer funcionar las rutas virtuales, pero eso como programador que eres te debería hacer saltar una pregunta "¿Cómo es que hace eso?" y la respuesta es simple y puede que ya lo entiendas gracias al código de configuración de nginx que coloqué antes:
</p>
<p>
Supongamos que entramos en la ruta <code>/hola</code> (o sea, <code>misitio.com/hola</code>), lo que hará el <code>.htacess</code> o la configuración nginx será lo siguiente:
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 <ahref="#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.
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:
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 <ahref="https://git.kj2.me/kj/duckbrain">Duckbrain</a>.
</p>
<p>
La siguiente línea también es la definición de una constante:
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:
Este bloque define un autoloader para PHP. Como su nombre lo indica, lo que hace es cargar los archivos en función del su clase, considerando siempre que dichos archivos estarán dentro de la carpeta configurada en <code>ROOT_CORE</code>, que generalmente será <code>src</code>.
</p>
<p>
Si aún no te ha hecho clic lo bonito que es tener un autoloader como este, básicamente lo que sucede es que en lugar de que a cada archivo que uses lo tengas que cargar usando la función <code>include()</code>, <code>require()</code>, <code>include_once()</code> o <code>require_once()</code>, bastará solo con usar la clase que contiene, siguiendo la convención de que el <code>namespace</code> indica las carpetas y el nombre del archivo tiene el mismo nombre de la clase.
</p>
<p>
Si aún no lo entendiste, no pierdas tiempo releyendo el párrafo anterior, en seguida lo vamos a retomar y a explicar mejor. Por lo pronto vamos a por el bloque final:
La primera línea de código lista todos los archivos <code>.php</code> dentro de nuestra carpeta <code>src/Routers/</code>, la segunda parte los incluye todos esos archivos PHP, o sea, ejecuta el código PHP que tengan dentro y la última llama a la clase <code>\Lib\Router::apply()</code> y aquí hacemos uso del bloque anterior de la siguiente manera:
</p>
<p>
Hasta ahora, el único archivo que hemos cargado es el de configuración en la primera línea. La clase <code>\Libs\Router</code> realmente no está definida y en un PHP normal nos daría error por ello, pero aquí viene al rescate nuestro autoloader, ya que el toma la clase y como se llama <code>\Lib\Router</code> comprende que tiene que intentar cargar el archivo en <code>src/Libs/Router.php</code> que es donde vendría a estar la clase que estamos necesitando. Como el archivo existe y la clase está definida allí, es capaz de cargarla y de correr la función estática <code>apply()</code> y así es como todos terminan felices sin dar ningún error :).
</p>
<p>
Nótese que lo que ha hecho el autoloader es convertir los backslashes o barras invertidas en slashes o barrar normales y luego concatenarlas con <code>ROOT_CORE</code> para obtener la ruta de nuestro archivo. Esto es muy importante, así que si no lo entiendes léelo nuevamente (explicación y código) o pide a algún amigo, conocido o random de internet en algún foro o chat de telegram, matrix, steam, discord, reddit, etc. que te lo explique hasta que comprendas perfectamente ese fracmento de código.
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.
</p>
<p>
Si abres el archivo <code>src/Libs/Router.php</code> verás que en su primera línea dice esto:
Esa línea generalmente será la primera siempre de un archivo PHP que use namespaces, no puede haber ninguna otra línea de código. Lo que hace dicha línea es darle una "familia" a la clase y con dicha familia, también viene el apellido de la misma.
</p>
<p>
De modo que cualquier clase que se cree dentro de un archivo con un namespace, de ahora en adelante tendrá como "apellido" ese namespace en su nombre. De ese modo, como en el archivo Router declaramos la clase <code>Router</code>, en realidad estamos creando la clase <code>Libs\Router</code> (el backslash del inicio se puede omitir).
</p>
<p>
Puede que ahora mismo no notes la utilidad de esto, pero es algo muy útil realmente y ya verás más adelante la magia que supone.
Desde luego esta la carpeta con <ahref="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:
</p>
<divclass="org-src-container">
<preclass="src src-bash">php -S localhost:80
</pre>
</div>
<p>
Eso te creará un webserver que podrás acceder escribiendo en el navegador <code>http://localhost</code> y verás lo que estemos corriendo en el proyecto.
</p>
<p>
En la terminal, ahora verás los logs de acceso y en caso de que tu código tenga un error, igual aparecerá allí. En el caso de Linux, MAC y FreeBSD los accesos se verán en amarillo para errores no fatales como archivos inexistente y en rojo si es un error fatal que detiene la ejecución de PHP. En Windows no estoy seguro.
</p>
<p>
He conocido gente que usa directamente un hosting y edita los archivos allí. Eso no está mal si estás aprendiendo o para hacer código rápido, pero en lo personal, siempre recomiendo desarrollar en local, ya que es más rápido y con herramientas como Docker o KVM puedes simular la misma configuración que tendría un servidor en producción, con los retoques que necesites para tu entorno de desarrollo.
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>.
</p>
<p>
Para ello vamos a la carpeta <code>src/Routers</code> y crearemos un archivo con el nombre de <code>main.php</code> y dentro colocaremos el siguiente código:
Lo que estámos haciendo aquí, es llamar al método <code>get</code> de la clase <code>Router</code>. La clase, como indica su nombre, maneja las rutas, el método <code>get</code> indica el <ahref="https://es.wikipedia.org/wiki/Protocolo_de_transferencia_de_hipertexto#M%C3%A9todos_de_petici%C3%B3n">método HTTP</a> que vamos a configurar (<ahref="https://git.kj2.me/kj/duckbrain">Duckbrain</a> soporta los métodos HTTP: get, post, put, patch y delete).
</p>
<p>
<b>Los parámetros que recibe la función son 2:</b>
</p>
<ulclass="org-ul">
<li><spanclass="underline">La ruta que vamos a configurar:</span> En este caso es <code>/</code> que es la raíz de nuestro dominio, o sea, <code>http://localhost/</code>. Prueba ahora mismo cambiar eso a <code>/hola</code> y verás que al refrescar ahora da <code>error 404</code>, pero al entrar en <code>http://localhost/hola</code> nuevamente podrás ver el mensaje <code>Hola mundo</code>.</li>
<li><spanclass="underline">Una función anónima:</span> Por lo pronto quédate que en ese segundo parámetro va un elemento <code>callable</code>, en este caso es una función anónima, lo cual entra dentro de las cosas que son <code>callable</code>. Este segúndo parámetro, como se puede deducir con facilidad, es lo que se ejecutará cuando ingresemos a la ruta configurada en el primer parámetro.</li>
Al igual que en <ahref="#orgb6ac824">Extra: Namespaces</a> la explicación de las primeras 2 líneas de este código, realmente no es algo de <ahref="https://git.kj2.me/kj/duckbrain">Duckbrain</a>, sino del lenguaje mismo, pero de todos modos lo explicaré.
Puedes probarlo y verás que funciona perfectamente. El problema es que en códigos más largos, con namespaces más largos, sería demasiado tedioso escribir el nombre completo de las clases todo el tiempo, del mismo modo que en la vida real sería tedioso referirnos a las personas siempre por sus nombres completos y en su lugar los llamamos por su nombre de pila o un apodo.
</p>
<p>
Si un <code>namespace</code> es como dar un apellido, <code>use</code> es como dar un apodo o nombre temporal. Por defecto, ese apodo o nombre local será el nombre de pila de la clase, pero igual podemos definirlo de la siguente manera:
En este caso, estamos usando la plabra reservada <code>as</code> para definir arbitrariamente que el apodo de <code>Libs\Router</code> será, <code>Rutercito</code>. El código ahora entenderá a qué clase nos referimos ya sea que usemos el nombre completo o el apodo <code>Routecito</code>.
</p>
<p>
Prueba ponerle apodos ambas clases y usar sus distintos nombres en el código. Es importante que siempre que aprendas, pruebes por cuenta propia las cosas, así te aburres menos y es mas fácil que lo comprendas.
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:
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.
</p>
<p>
Como medida de seguridad, existirá una llave secreta que se usará para encriptar la nota y dicha llave secreta no se guardará en nuestra base de datos, sino que irá en el enlace que le daremos a la persona a la hora de crear su texto secreto. De modo que las únicas personas capaces de desencriptar ese texto secreto, serán aquellas que tengan ese enlace.
</p>
<p>
Como extra, la notas tendrán siempre un tiempo de expiración definido por el creador de la nota y/o una cantidad de lecturas máximas, luego de lo cual ya se podrán desencriptar y serán eliminadas de nuestra base de datos si alguien intenta leerlas.
</p>
<p>
El nombre de la aplicación será <b>Ignota</b>. No soy bueno con los nombres y pensaba que podría llamarla Ignita nota (nota de fuego en latín) e intentando crear un apócope, llegué a una palabra que ya existe en español y además tiene un significado acorde, además de tener la palabra "nota" en el nombre :).
<ahref="https://git.kj2.me/kj/duckbrain">Duckbrain</a> soporta también MySQL/MariaDB, por lo que si quisieramos usar dicho gestor, el código sería así:
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.
Desde luego, <ahref="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:
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<sub>URL</sub> 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 <code>/</code>.
Como nuestra base de dato es solo un archivo sqlite, no requerimos de <code>DB_HOST</code>, <code>DB_USER</code> ni <code>DB_PASS</code>. Todas esas líneas podemos eliminarlas o dejarlas tal cual, pues no afectarán en nada.
Debo hacer incapié en que nada está escrito en piedra y podemos hacer las cosas de muchas manera con <ahref="https://git.kj2.me/kj/duckbrain">Duckbrain</a>, pero en este caso, siguiendo la estructura MVC, vamos a crear modelos, vistas y controladores.
</p>
<p>
Comenzando con los modelos, que en realidad para este proyecto sería en singular, vamos a crear un archivo llamado <code>Note.php</code> en <code>src/Models</code> con el siguiente contenido:
En el caso de los modelos que extienden de <code>Libs\Model</code> es necesario poner como públicos los nombres de las variables que queremos que se guarden o traigan de la base de datos. Del mismo modo es importante el nombre de la clase, ya que esta se pasará de <code>PascalCase</code> a <code>snake_case</code> en plural (añadiendo una <code>s</code> al final), para usarlo como tabla, o dicho más simple, como la clase se llama <code>Note</code>, la tabla con la que estará asociada será <code>notes</code>. Si por otro lado la clase se llamara <code>EncriptedNote</code>, la tabla en la base de datos tendría que llamarse <code>encripted_notes</code>.
</p>
<p>
Repitiendo otra vez lo antes dicho ya muchas veces, nada está escrito en piedra y si quieres usar un nombre de la tabla y no hacer uso de la conversión de nomenclaturas antes mencionada, puedes hacerlo definiendo la propiedad protegida <code>table</code>. Del mismo modo, si quieres tener alguna propiedad privada o protegida en lugar de pública, pero igualmente quieres que se guarde, solo debes definirlo en la propiedad <code>forceSave</code> y si lo que quieres es todo lo contrario (que una propiedad pública no se guarde), entonces podrías hacer uso de la propiedad <code>ignoreSave</code>.
</p>
<p>
Nada de lo mencionado en el anterior párrafo lo necesitaremos, pero de todos modos aquí tienes un ejemplo de como se vería:
<spanstyle="color: #b22222;">// </span><spanstyle="color: #b22222;">Cambiamos el nombre de la tabla a la que se relacionará nuestro modelo.</span>
<spanstyle="color: #b22222;">// </span><spanstyle="color: #b22222;">Forzamos a que se guarden las propiedades salt y password a pesar de que no son públicas.</span>
<b>Nota:</b> En esta ocasión no explicaré qué es lo que hace la palabra reservada <code>extends</code>. Si no comprendes lo que hace, por favor busca y pregunta ya que es algo extremadamente importante de comprender, además de ser algo que se usa en prácticamente todos los lenguajes de programación que soportan clases.
<<spanstyle="color: #0000ff;">label</span><spanstyle="color: #a0522d;">for</span>=<spanstyle="color: #8b2252;">"expiration"</span>>Tiempo de expiración (en minutos):</<spanstyle="color: #0000ff;">label</span>>
Ahora no vamos a hacer un archivos completos, los haremos a pedacitos de código a medida que avancemos.
</p>
<p>
Comenzando con el controlador, vamos a crear un archivo llamado <code>NoteController.php</code> en la carpeta <code>src/Controllers/</code> y colocaremos dentro este código:
Aquí lo que hemos hecho ha sido crear una función estática dentro de nuestro controlador, el ejecutará el metodo <code>render</code>, de la librería <code>View</code> (<code>Libs\View</code>) el cual en de manera interna en lo que hace es crear un objeto de tipo <code>View</code> y ejecutar el método <code>html</code> con los mismos argumentos que recibe el método render. Puedes comprobarlo tú mismo leyendo el código de esa librería, es cortito y no muerde.
</p>
<p>
Luego eso lo que teminará haciendo es buscar un archivo llamado <code>CreateNote.php</code> dentro de <code>src/Views/</code> y lo cargará, de modo que terminaríamos viendo el formulario que creamos antes.
</p>
<p>
Sin embargo, aún nos falta un paso para que ese formulario se vea y es configurar la ruta donde se verá. Para hacerlo, vamos a renombrar el archivo <code>main.php</code> que creamos antes y como estas rutas que configuraremos son las rutas de nuestras notas, un buen nombre a usar sería <code>note.php</code>, si luego tuvieramos, usuarios entonces podríamos crear otro archivos llamado <code>user.php</code> y poner allí todas las rutas que sean de usuarios.
</p>
<p>
Bueno, siguendo a lo que íbamos. Si es que has estado tomando antención, el contenido de este archivo tiene que ser la configuración de una ruta que ejecute la función <code>home</code> que creamos antes en el controlador.
</p>
<p>
Aquí me doy el lujo de hacer otro paréntesis para hablar del tipo <code>callable</code> de PHP. Esto es un tipo especial, ya que no es una clase realmente, de hecho puede ser un <code>array</code>, una función anónima o un <code>string</code> sin problemas. La única condición es que debe ser algo que puedas llamar como función, de modo que el contenido de nuestro archivo <code>note.php</code> lo podremos poner de una de estas 2 maneras:
Enlos anteriores 2 bloques de código lo que hemos visto han sido 2 maneras de escribir un callable:
</p>
<p>
En el primer código he escrito el nombre completo hasta la función en un string, mientras que en el segundo hemos hecho lo mismo, pero en forma de array. Ambos funcionan como <code>callables</code>, ya que se podrían ejecutar como función y puedes comprobarlo tú mismo intentando correr el siguiente código:
Sé que esto es algo raro y que realmente tiene que ver con el conocimiendo de PHP, pero tenía que mencionarlo porque me he topado con gente que usa frameworks como laravel y creen que eso es algo que sucede por "la magia del framework" y es un error.
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:
Con esto podemos encriptar la nota antes de guardarla y nos devolverá una llave aleatoria con la que habrá encriptado el texto.
</p>
<p>
Ahora vamos a hacer un controlador que recibirá el formulario, encriptará la nota para luego guardarla en la base de datos y finalmente redirigirá al enlace de la nota que llevará en la URL la llave de encriptado, para ello añadiremos esta función a la clase <code>NoteController</code>:
Si te sientes permido y no sabes dónde poner esas 2 líneas, es arriba de la línea que comeniza con <code>class</code>, de hecho ahí verás otras líneas similares.
</p>
<p>
Para finalizar vamos configurar la ruta. Así que editamos el archivo <code>note.php</code> que está en <code>src/Routers/</code> y le añadimos:
Esta vez, como la petición viene de un formulario que la enviará mediande el método HTTP POST, al momento de configurar nuestra ruta, en lugar de usar el <code>Router::get</code> que hemos estado usando hasta ahora, usamos <code>Router::post</code>.
</p>
<p>
Ahora ya podemos comenzar a crear nuestras notas, auque aún no las podremos ver.
<spanstyle="color: #008b8b;">$</span><spanstyle="color: #008b8b;">this</span>-><spanstyle="color: #a0522d;">content</span> = <spanstyle="color: #8b2252;">'La nota se ha destruido por expiración.'</span>;
<spanstyle="color: #008b8b;">$</span><spanstyle="color: #008b8b;">this</span>-><spanstyle="color: #a0522d;">content</span> = <spanstyle="color: #8b2252;">'La nota se ha destruido según su límite de vistas.'</span>;
En este código hay 2 cosas nuevas de <ahref="https://git.kj2.me/kj/duckbrain">Duckbrain</a> que aún no hemos visto:
</p>
<p>
La primera serían los atributos <code>$request->params->id</code> y <code>$request->params->key</code> que propablemente te preguntes de dónde salen. Pero aún es momento de que te los explique, por lo que ten paciencia que no fatla mucho.
</p>
<p>
La segunda cosa es el método <code>text</code> de la librería <code>View</code>: Este método lo que hace es imprimir en texto plano lo que le enviemos, dicho de otro modo, en lugar de devolver el usual documento html que suelen cargar todas lás páginas, simulará que estamos abriendo un archivo <code>.txt</code>.
</p>
<p>
Ahora la cerecita del paste: Vamos a configurar el router, así que editamos nuestro archivo <code>src/Views/note.php</code> y le añadimos la siguiente línea:
Ahora notarás que esta vez tiene algo singular que no hemos visto antes y es que en la ruta hay textos encerrados entre llaves. Lo que eso quiere decir es que el texto allí puede ser arbitrario y que lo que pongas allí se guardará en una variable y si ya uniste las líneas esas variables luego podremos accederlas mediante <code>$request->params->id</code> y <code>$request->params->key</code> respectivamente (llevan el mismo nombre alfinal por algo).
</p>
<p>
Por si aún no se entiende, habamos un ejemplo:
</p>
<p>
Supongamos que entramos mediante la url: <code>http://localhost/52/urE44g4we4r14daFifG</code> entonces el valor de <code>$request->params->id</code> sería <code>52</code>, mientras que el de <code>$request->params->key</code> sería <code>urE44g4we4r14daFifG</code>.
</p>
<p>
Si aún no lo entiendes, te recomiendo testearlo cambiando esos valores e imprimiendo los valores de esas variables en el método <code>show</code> de <code>NoteController</code>.
</p>
<p>
Y con eso ya hemos terminado, ya puedes probar la aplicación, intentar romperla, etc.
</p>
<p>
Ya puedes comenzar a hacer tus propias aplicaciones, no tienes ninguna idea de qué hacer, te reto a hacer lo siguiente:
</p>
<p>
Crea una aplicación de gestión tareas (un TODO list), en donde puedas agregar tareas, marcarlas como finalizadas, en espera o canceladas. Si te parece sencillo hasta ahí, añade que el sistema tendrá usuarios que deberán loguearse, cada uno tendrá sus propias listas de tareas que solo ellos pueden ver cuando se loguean.
Por si alguien se perdió o sencillamente quiere ver código, he subido la aplicación ignota en este repositorio:
</p>
<p>
[URL faltante]
</p>
<p>
Te animo a hacerle un fork, mejorarlo y enviármelo. Los forks que me parezcan interesantes, los colocaré como destacados en el repositorio original para que otros puedan verlos.
