Download the PHP package israeldavidvm/name-helper without Composer
On this page you can find all versions of the php package israeldavidvm/name-helper. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download israeldavidvm/name-helper
More information about israeldavidvm/name-helper
Files in israeldavidvm/name-helper
Package name-helper
Short Description Manage file names, responsive images, URLs and more with ease!The NameHelper repository offers you a complete library to simplify working with names in your application.The NameHelper class provides a collection of utility functions for working with image names, particularly in the context of generating responsive image URLs. It also includes auxiliary functions for manipulating file names and some special functions that allow the generation of urls specially designed for Laravel.I usually use this package with other packages created by me such as ImageCompressor and SmartImage.
License LGPL-3.0-or-later
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package name-helper
NameHelper
Readme version in English
¡Maneja nombres de archivos, imagenes responsive, URLs y más con facilidad!
Table of Contents generated with DocToc
- NameHelper
- ¡Maneja nombres de archivos, imagenes responsive, URLs y más con facilidad!
- Licencia
- Caracteristicas ¿Qué te ofrece NameHelper?
- Documentacion
- Manejo de nombres de archivo, ruta en el sistema de archivos linux o url
- Retornar la extension de un archivo a partir de un \<fileLocatorName>. 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 \<fileLocatorName>
- Retorna el nombre de un archivo o directorio a partir de un \<fileLocatorName>
- Conversor de nombres a nombres de url
- Generacion de nombres para Images responsivas
- Generacion de urls para Images
- Gramatica para las url
- Convenciones de notacion para la gramatica:
- Gramatica de las urls
- Generacion de rutas para Imagenes Responsivas, no responsivas locales y externas
- Ruta a Imagen no responsiva local o externa
- Rutas a imagenes locales o externas responsivas
- ConventionalDir
- Externa o interna
- Almacenar las rutas a un imagen en la base de datos:
- Rutas para ser almacenadas en BD de recursos como imagenes o directorios locales siguiendo las convenciones de laravel:
- Rutas para trabajar con el Storage de recursos como imagenes o directorios locales siguiendo las convenciones de laravel:
- Ejemplos de uso
- Almacenar la ruta base de una imagen en la base de datos
- Usando la convencion de Laravel y la convencion de directoros con el mismo nombre de la imagen para imagenes locales
- Usando solo la convencion de directoros con el mismo nombre de la imagen
- Recuperar imagenes en la bd:
- Mas ejemplos de uso
- Make a donation. Your contribution will make a difference.
- Find me on:
- Technologies used / Tecnologias usadas
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 \<fileLocatorName>. 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 \<fileLocatorName>
Retorna el nombre de un archivo o directorio a partir de un \<fileLocatorName>
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.
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
Gramatica de las urls
De manera que la libreria utilizara la siguiente gramatica para sus urls
Donde: Los metodos que contienen InLaravelConvetionalLink suelen darle el valor a
Y los metodos que contienen InLaravelConvetionalStorage suelen darle el valor a
Donde: Los metodos que contienen InConvetionalDir suelen darle el valor a
Notese que la diferencia entre una url externa he interna se basa en el valor de
Generacion de rutas para Imagenes Responsivas, no responsivas locales y externas
La diferencia entre una imagen responsiva y otro que no lo es radica en que para la imagen responsiva se utilizaran conjuntos de url una por cada variacion de la imagen y en la otra no. De manera que tendran una forma como la siguiente
Ruta a Imagen no responsiva local o externa
Como por ejemplo
Rutas a imagenes locales o externas responsivas
Para este caso se generara un conjunto de rutas con la sitaxis de las imagenes no responsivas
Como por ejemplo
ConventionalDir
Donde: Los metodos que contienen InConvetionalDir suelen darle el valor a
Externa o interna
Notese que la diferencia entre una url externa he interna se basa en el valor de
Almacenar las rutas a un imagen en la base de datos:
Con el objetivo de permitir que el almacenamiento de las imagenes sea lo mas flexible posible, se hara lo siguiente.
Se guardara la ruta al directorio de la carpeta que la contiene (solo la carpeta sin el nombre de la imagen) y el nombre de la imagen en la base de datos.
De forma que se pueda tomar esa ruta base, el nombre de la imagen y generar una ruta o conjunto de rutas dependiendo de si la imagen es responsive o no.
Rutas para ser almacenadas en BD de recursos como imagenes o directorios locales siguiendo las convenciones de laravel:
A la hora de almacenar la url de nuestros recursos (como imagenes imagenes, directorios, etc), deberiamos considerar almacenar la url que nos permite acceder al recurso de forma publica, en la configuracion por defecto de laravel hay una ruta contemplada para ello.
De modo que desarrollamos una serie de metodos que terminan en InLaravelConvetionalLink que generara una url hacia dichas rutas.
Rutas para trabajar con el Storage de recursos como imagenes o directorios locales siguiendo las convenciones de laravel:
Al igual que existe una convencion para las rutas hacia los recursos que son accesibles de forma publica existe una convencion para las rutas reales hacia los recursos en la configuracion por defecto de laravel.
Ejemplos de uso
Almacenar la ruta base de una imagen en la base de datos
Como dijimos anteriormente uno de los enfoques que se pueden tomar para maximizar la flexibilidad a la hora de trabajar con imagenes
Es el de solo almacenar la ruta en la que se almacena la imagen
Usando la convencion de Laravel y la convencion de directoros con el mismo nombre de la imagen para imagenes locales
Que para el caso en que queramos usar la convencion de laravel debera ser la que es accesible de forma publica ruta que puede ser obtenida por medio del metodo
Lo que generara una url de imagen como
Notese que dicho metodo anexa una carpeta al final de la ruta que usa laravel por convencion
Usando solo la convencion de directoros con el mismo nombre de la imagen
Que puede ser obtenida por el metodo, notese que dependiendo de si la base url es externa o no se hablara de imagen externa o interna
Como por ejemplo
Recuperar imagenes en la bd:
En caso de haber almacenado la ruta completa hacia la carpeta que contiene el recurso en la base de datos como recomendamos
Los nombres de las imagenes podran ser recuperados de la siguiete forma
cuando la imagen es responsiva o
cuando la imagen no es responsiva.
En caso de no haber almacenado la ruta completa hacia la carpeta que contiene el recurso en la base de datos como recomendamos
O
que añadiran la informacion necesaria
Mas ejemplos de uso
Make a donation. Your contribution will make a difference.
Find me on:
Technologies used / Tecnologias usadas
[
