Git Product home page Git Product logo

filename's Introduction

Pretty File Name

This library generates pretty, clean, user friendly, unique and well formatted file name.

Total Downloads License

Video Tutorial

Laravel Filename

Laravel Installation

Install using composer:

composer require salmanbe/filename

There is a service provider included for integration with the Laravel framework. This service should automatically be registered else to register the service provider, add the following to the providers array in config/app.php:

Salmanbe\FileName\FileNameServiceProvider::class,

You can also add it as a Facade in config/app.php:

'Filename' => Salmanbe\FileName\FileName::class,

Basic Usage

Add use Salmanbe\FileName\FileName; or use FileName; at top of the class where you want to use it.

$filename = 'visa-_ application With fréé.PNG';
echo FileName::get($filename);  // visa-application-with-free-2021-02-16-001454.png

Options

You can generate configuration file by php artisan vendor:publish command. Global file name generation options can be defined in it. However, you can override options by adding additional array parameter.

Timestamp

echo FileName::get($filename, ['timestamp' => 'Y-m-d']]);

You can override default timestamp format that is placed at the end of file name before extension.

Slugify

echo FileName::get($filename, ['slugify' => true]]);

Removes special characters from file name.

Limit

echo FileName::get($filename, ['limit' => 200]]);

Limit the total number of characters in file name to avoid very long file name. Default recommended maximum limit is 240.

Separator

echo FileName::get($filename, ['separator' => '_']]);

You can specify the separator between file name words. Default separator is '-'.

Uppercase

echo FileName::get($filename, ['uppercase' => true]]);

File name is generated by default in lower case. However, you can use this option to generate file name in upper case.

All Options

echo FileName::get($filename, [
            'limit' => 200,
            'timestamp' => date('d-m-Y-His'),
            'slugify' => true,
            'separator' => '-',
            'uppercase' => true
    ]);

Global Configuration

Run php artisan vendor:publish --provider="Salmanbe\FileName\FileNameServiceProvider" to publish configuration file.

'timestamp' => 'Y-m-d-His',

If set to false then no timestamp will be added at the end of file name. It is possible to change the timestamp format. This value can be overridden when calling the function.

'limit' => 225,

If set to false then by default first 225 characters will be used. This value can be overridden when calling the function.

'slugify' => true,

If set to true then special characters will be removed from the file name. This value can be overridden when calling the function.

'separator' => '-',

If set then it will be used as separator between file name words. This value can be overridden when calling the function.

'uppercase' => false,

If set to true then file name will be in uppercase else lowercase. This value can be overridden when calling the function.

Uninstall

First remove Salmanbe\FileName\FileNameServiceProvider::class, and 'Filename' => Salmanbe\FileName\FileName::class, from config/app.php if it was added. Then Run composer remove salmanbe/filename

License

Laravel Perfect Filename is licensed under THE MIT License. Please see License File for more information.

Security contact information

To report a security vulnerability, follow these steps.

filename's People

Contributors

salmanbe avatar

Stargazers

Bilal Haidar avatar

Watchers

 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.