https://github.com/ryangjchandler/laravel-helpers

A collection of helper functions that I use across my projects.
https://github.com/ryangjchandler/laravel-helpers

Last synced: about 5 hours ago
JSON representation

A collection of helper functions that I use across my projects.

• Host: GitHub
• URL: https://github.com/ryangjchandler/laravel-helpers
• Owner: ryangjchandler
• License: mit
• Created: 2021-07-18T20:06:41.000Z (over 3 years ago)
• Default Branch: main
• Last Pushed: 2024-09-20T15:48:06.000Z (4 months ago)
• Last Synced: 2025-01-02T09:12:16.363Z (7 days ago)
• Language: PHP
• Homepage:
• Size: 58.6 KB
• Stars: 34
• Watchers: 1
• Forks: 3
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • Contributing: .github/CONTRIBUTING.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE.md
  • Security: .github/SECURITY.md

Awesome Lists containing this project

README

        
# A collection of helper functions that I use across my projects.

[![Latest Version on Packagist](https://img.shields.io/packagist/v/ryangjchandler/laravel-helpers.svg?style=flat-square)](https://packagist.org/packages/ryangjchandler/laravel-helpers)

[![GitHub Tests Action Status](https://img.shields.io/github/workflow/status/ryangjchandler/laravel-helpers/run-tests?label=tests)](https://github.com/ryangjchandler/laravel-helpers/actions?query=workflow%3Arun-tests+branch%3Amain)

[![GitHub Code Style Action Status](https://img.shields.io/github/workflow/status/ryangjchandler/laravel-helpers/Check%20&%20fix%20styling?label=code%20style)](https://github.com/ryangjchandler/laravel-helpers/actions?query=workflow%3A"Check+%26+fix+styling"+branch%3Amain)

[![Total Downloads](https://img.shields.io/packagist/dt/ryangjchandler/laravel-helpers.svg?style=flat-square)](https://packagist.org/packages/ryangjchandler/laravel-helpers)

This package includes some of the helper functions that I tend to use in all of my projects.

## Installation

You can install the package via composer:

```bash

composer require ryangjchandler/laravel-helpers

```

## Usage

### `user`

Returns the current user, or null depending on authentication status.

> This function assumes that your `User` model is found inside of `app/Models` and will not be registered if that class doesn't exist.

```php

$user = user();

```

### `route_is`

Check if the current route name matches the provided string.

```php

route_is('dashboard.index');

```

### `authorize`

Identical to Laravel's `$this->authorize()` method provided by the `AuthorizesRequests` trait.

```php

public function index()

{

    authorize('viewAny', Post::class);

}

```

### `attributes()` and `@attributes`

Laravel 9 introduces new directives for checked, disabled and selected. In some cases though, you might want to output a variety of different attributes using PHP values.

`attributes()` and the `@attributes()` directive can help with that:

```blade

 ! $user->can('click'),

])>

```

### `mdash()`

It's quite common to output an `—` in your HTML code when it isn't present. Doing this with regular Blade `{{ }}` tags can be annoying though since `—` needs to be output in "raw" mode.

This function uses `HtmlString` to return a "safe" wrapper around the HTML entity which allows it to be output without being escaped.

```blade

{{ $post->published_at?->format('d/m/Y') ?? mdash() }}

```

## Testing

```bash

composer test

```

## Changelog

Please see [CHANGELOG](CHANGELOG.md) for more information on what has changed recently.

## Contributing

Please see [CONTRIBUTING](.github/CONTRIBUTING.md) for details.

## Security Vulnerabilities

Please review [our security policy](../../security/policy) on how to report security vulnerabilities.

## Credits

- [Ryan Chandler](https://github.com/ryangjchandler)

- [All Contributors](../../contributors)

## License

The MIT License (MIT). Please see [License File](LICENSE.md) for more information.