Download the PHP package israeldavidvm/name-helper without Composer

NameHelper

Readme version in English

¡Maneja nombres de archivos, imagenes responsive, URLs y más con facilidad!

El repositorio NameHelper te ofrece una librería completa para simplificar el trabajo con nombres en tu aplicación.

La clase NameHelper proporciona una colección de funciones de utilidad para trabajar con nombres de imágenes, particularmente en el contexto de generar URL de imágenes responsivas. También incluye funciones auxiliares para la manipulación de nombres de archivos y algunas funciones especiales que permiten la generacion de urls especialmente diseñadas para laravel

Este paquete lo suelo usar con otro paquetes creados por mi como ImageCompressor y SmartImage.

Licencia

Este código tiene licencia bajo la licencia pública general de GNU versión 3.0 o posterior (LGPLV3+). Puede encontrar una copia completa de la licencia en https://www.gnu.org/licenses/lgpl-3.0-standalone.htmlalone.html0-standalone.html

Caracteristicas ¿Qué te ofrece NameHelper?

• Transforma nombres en formatos compatibles con URLs:

  • Convierte nombres a minúsculas (UTF-8).
  • Reemplaza espacios y guiones bajos por guiones.
  • Sustituye caracteres especiales por equivalentes alfanuméricos (por ejemplo, "á" se convierte en "a").
  • Elimina signos de puntuación y símbolos no aptos para URLs.

• Genera variaciones de nombres responsivos para imágenes:

• Crea nombres de imágenes con la mayoria de los tamaños recomendados que deberia de tener una imagen responsive (por ejemplo, "360-imagen.jpg").

• Genera URLs para imágenes locales y externas, responsivas y no responsivas.

• Crea URLs optimizadas para el framework Laravel.

• Facilita el trabajo con el nombre de archivos, extensiones o directorios

Documentacion

NameHelper proporciona una colección de funciones útiles para manipular nombres de archivos, URLs y generar URLs para imágenes.

Manejo de nombres de archivo, ruta en el sistema de archivos linux o url

La libreria tambien proporciona una serie de formas de trabajar con los nombres de archivos presentes en lo que nosotros llamamos un $fileLocatorName que no es mas que una cadena que hace referencia a un nombre de archivo, ruta en el sistema de archivos en linux o url

De manera que podemos

Retornar la extension de un archivo a partir de un . Nota el archivo no deberia ser un directorio pues los directorios no tienen extension se emitira un assertion en caso de pasar un directorio en lugar de un archivo

Retornar el nombre de un archivo o directorio sin la extension a partir de un

Retorna el nombre de un archivo o directorio a partir de un

Conversor de nombres a nombres de url

Una de las cosas que ofrece esta libreria es una manera sencilla de pasar nombres a nombres de url.

Supongase que se quiere usar el nombre de los post de un blog como UN identificador por medio de la url.

De forma que para acceder al post titulado "hello world" se acceda a la ruta www.miblog.com/blog/hello-world

Aqui podemos usar la funcion

La cual al pasar como parametro $name="hello world" retornara hello-world

Generacion de nombres para Images responsivas

Si queremos generar una lista de nombres para imagenes responsivas ejecutamos el metodo

el cual para un parametro $imageName=image.jpg retornara un array asociativo

Generacion de urls para Images

Esta libreria busca dar soporte a imagenes normales, responsive y con almacenamiento local o externo.

Para lo cual se presupone que las variaciones de una imagen responsive se agrupan en una carpeta.

Tambien se busca facilitar el uso de convenciones: para lo cual se estandariza una para generacion de el nombres para las carpetas que almacenan las variaciones de una imagen responsive y la carpeta donde se almacenan las imagenes en laravel.

De forma que existen metodos especiales que siguen estas convenciones a los cuales se les incluye la palabra Conventional y LaravelConvetional

Gramatica para las url

Convenciones de notacion para la gramatica:

Los <> se utilizan para rodear un simbolo no terminal

El ::= se utiliza para reglas de produccion

Los simbolos no terminales se expresan como una cadena o caracteres normales

El siguiente grupo de pares de simbolos, se deben utilizar junto a las expresiones de la siguiente forma: el primero en cada pareja se escribe como sufijo despues de la expresion y el segundo rodea la expresion.

El ? o [] indican que la expresion es opcional

El * o {} indica que la expresion se repite 0 o mas veces

El + indica que la expresion se repite 1 o mas veces

Si se quiere usar uno de los caracteres anteriores se debe de anteceder \ con

De manera que la libreria utilizara la siguiente gramatica para sus urls

Donde: Los metodos que contienen la palabra LaravelConvetional suelen darle el valor a

Donde: Los metodos que contienen la palabra Convetional suelen darle el valor a

Notese que la diferencia entre una url externa he interna se basa en el valor de

Imagen no responsiva local para laravel

Como por ejemplo

Imagen local responsiva para laravel

Como por ejemplo

Imagen no responsiva local o externa convencional

Como por ejemplo

Imagen local o externa responsiva convencional

Como por ejemplo

Imagen no responsiva local o externa

Como por ejemplo

Imagen local o externa responsiva

Como por ejemplo

Ejemplos de uso

Almacenar la url de las imagenes en la bd:

Para almacenar una imagen responsive en la base de datos de una aplicacion laravel se recomienda usar

Lo que generara una url de imagen como

Para el caso de imagenes no responsivas

Lo que generara una url de imagen como

Recuperar imagenes en la bd:

Notese que las imagenes responsives estan almacenadas en un directorio

De manera que los nombres para cada una de las imagenes responsive deben obtenerse por medio de

o

O

Find me on:

Technologies used / Tecnologias usadas

[]()