49

If I wanted to make a currentUser() function for some oauth stuff I am doing where I can use it in a view or in a controller (think rails, where you do helper_method: current_user in the application controller).

Everything I read states to create a helpers folder and add the function there and then that way you can do Helpers::functionName Is this the right way to do this?

Whats the "laravel way" of creating helper functions that can be used in blade templates and controllers?

1

5 Answers 5

88

Create a new file in your app/Helpers directory name it AnythingHelper.php An example of my helper is :

<?php
function getDomesticCities()
{
$result = \App\Package::where('type', '=', 'domestic')
    ->groupBy('from_city')
    ->get(['from_city']);

return $result;
}

generate a service provider for your helper by following command

php artisan make:provider HelperServiceProvider

in the register function of your newly generated HelperServiceProvider.php add following code

require_once app_path('Helpers/AnythingHelper.php');

now in your config/app.php load this service provider and you are done

'App\Providers\HelperServiceProvider',
13
  • 1
    No, only above mentioned code does it, in your blade file do {{ yourHelperFunction('param') }} Jan 21, 2016 at 16:55
  • 1
    I dont think you access facades in blade, and if you can (by tweaking something) I am not sure whether it is a good practice Jan 21, 2016 at 17:03
  • 2
    I added alias/facade in config/app like: 'Helper' => App\Helpers\Helper::class, and I'm able to use the Helper::myHelperFunction('param') in blade.
    – MaXi32
    Jan 21, 2016 at 17:08
  • 3
    lol @ looks nicer. Facades are NOT nicer - and in most cases, bad practice to use them. Apr 14, 2016 at 3:10
  • 1
    AnythingHelper.php is just an example, you should replace this with original file name Oct 6, 2016 at 14:56
62

An easy and efficient way of creating a global functions file is to autoload it directly from Composer. The autoload section of composer accepts a files array that is automatically loaded.

  1. Create a functions.php file wherever you like. In this example, we are going to create in inside app/Helpers.

  2. Add your functions, but do not add a class or namespace.

    <?php
    
    function global_function_example($str)
    {
       return 'A Global Function with '. $str;
    }
    
  3. In composer.json inside the autoload section add the following line:

    "files": ["app/Helpers/functions.php"]
    

    Example for Laravel 5:

    "autoload": {
        "classmap": [
            "database"
        ],
        "psr-4": {
            "App\\": "app/"
        },
        "files": ["app/Helpers/functions.php"] // <-- Add this line
    },
    
  4. Run composer dump-autoload

Done! You may now access global_function_example('hello world') form any part of your application including Blade views.

6
  • 1
    I also need to create a global function where can be called in multiple controller files. This looks simple but what happens when run the command composer dump-autoload? Are new files been created? I even deleted the files like composer.json, gulpfile.js as I didn't think they were used at all.
    – Johnny
    May 17, 2017 at 7:32
  • Great! Running composer dump-autoload would be similar to clearing the composer cache. Basically, it re-evaluates the classes that need to be loaded from composer.json file. Good luck! May 30, 2017 at 21:14
  • Efficient method
    – Naveen DA
    Feb 17, 2018 at 5:15
  • 2
    much straightforward than the accepted answer. I tried both!
    – Philip E
    Mar 28, 2018 at 6:31
  • 1
    Love this implementation. Straight forward and faster!
    – realnsleo
    Mar 21, 2019 at 9:54
24

Laravel global helpers

Often you will find your self in need of a utility function that is access globally throughout you entire application. Borrowing from how laravel writes their default helpers you're able to extend the ability with your custom functions.

Create the helper file, not class

I prefer to you a file and not a class since I dont want to bother with namespaces and I want its functions to be accessible without the class prefixes like: greeting('Brian'); instead of Helper::greeting('Brian'); just like Laravel does with their helpers.

File: app/Support/helper.php

Register helper file with Composer: composer.json

{
    ...
    "autoload": {
        "classmap": [
            "database"
        ],
        "files": [
            "app/Support/helpers.php"
        ],
        "psr-4": {
            "App\\": "app/"
        }
    },
    ...
}

Create your first helper function

<?php

if (!function_exists('greet')) {
    /**
     * Greeting a person
     *
     * @param  string $person Name
     * @return string
     */
    function greet($person)
    {
        return 'Hello ' . $person;
    }
}

Usage:

Remember to autoload the file before trying to access its functions: composer dump-autoload

Let's test with Tinker

$ php artisan tinker
Psy Shell v0.8.17 (PHP 7.0.6 ΓÇö cli) by Justin Hileman
>>> greet('Brian');
=> "Hello Brian"
>>> exit
Exit:  Goodbye.

With Blade

<p>{{ greet('Brian') }}</p>

Advanced usage as Blade directive:

A times you will find yourself wanting to use a blade directive instead of a plain function. Register you Blade directive in the boot method of AppServiceProvider: app/Providers/AppServiceProvider.php

public function boot()
{
    // ...
    Blade::directive('greet', function ($expression) {
        return "<?php echo greet({$expression}); ?>";
    });
}

Usage: <p>@greet('Brian')</p>

Note: you might need to clear cache views php artisan view:clear

1
  • 1
    I had to do a composer dump-autoload for it to work
    – Gjaa
    Jun 5, 2020 at 20:16
6

The above answers are great with a slight complication, therefore this answer exists.

utils.php

if (!function_exists('printHello')) {

    function printHello()
    {
        return "Hello world!";
    }
}

in app/Providers/AppServiceProvider.php add the following in register method

public function register()
{
   require_once __DIR__ . "/path/to/utils.php"
}

now printHello function is accessible anywhere in code-base just as any other laravel global functions.

5

Another option, if you don't want to register all your helper functions one by one and wondering how to register them each time you create a new helper function:

Again in the app/Providers/AppServiceProvider.php add the following in register method

public function register()
{
    foreach (glob(app_path().'/Helpers/*.php') as $filename) {
        require_once($filename);
    }
}

Not the answer you're looking for? Browse other questions tagged or ask your own question.