Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/browner12/helpers
Helper Package
https://github.com/browner12/helpers
laravel php
Last synced: 6 days ago
JSON representation
Helper Package
- Host: GitHub
- URL: https://github.com/browner12/helpers
- Owner: browner12
- License: mit
- Created: 2015-11-16T23:41:16.000Z (about 9 years ago)
- Default Branch: master
- Last Pushed: 2024-03-14T18:56:16.000Z (10 months ago)
- Last Synced: 2024-12-15T01:05:39.231Z (14 days ago)
- Topics: laravel, php
- Language: PHP
- Homepage: http://brownprogramming.com
- Size: 84 KB
- Stars: 283
- Watchers: 12
- Forks: 43
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE.md
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
# Helpers
[![Latest Version on Packagist][ico-version]][link-packagist]
[![Software License][ico-license]](LICENSE.md)
[![Build Status][ico-travis]][link-travis]
[![Coverage Status][ico-scrutinizer]][link-scrutinizer]
[![Quality Score][ico-code-quality]][link-code-quality]
[![Total Downloads][ico-downloads]][link-downloads]
This is a helpers package that provides some built in helpers, and also provides an Artisan generator to quickly create your own custom helpers.
## Install
Via Composer
``` bash
$ composer require browner12/helpers
```
## Setup
Add the service provider to the providers array in `config/app.php`.
``` php
'providers' => [
browner12\helpers\HelperServiceProvider::class,
];
```
If you are using Laravel's automatic package discovery, you can skip this step.
## Publishing
You can publish everything at once
``` php
php artisan vendor:publish --provider="browner12\helpers\HelperServiceProvider"
```
or you can publish groups individually.
``` php
php artisan vendor:publish --provider="browner12\helpers\HelperServiceProvider" --tag="config"
```
## Usage
This package comes with some built in helpers that you can choose to use or not. By default all of these helpers are inactive for your application. To adjust which helpers are active and which are inactive, open `config/helpers.php` and find the `package_helpers` option. Add any helpers you wish to activate to this key. Check the source code to see what functions are included in each helper and what each does.
You can also create your own custom helpers for inclusion in your application. An Artisan generator helps you quickly make new helpers for your application.
``` sh
php artisan make:helper MyHelper
```
Your custom helper will be placed in `app/Helpers`, unless you override the default directory in your configuration.
By default, the service provider uses the `glob` function to automatically require any PHP files in the 'Helpers' directory. If you prefer a mapper based approach, you may edit the `custom_helpers` in the configuration file, and include the file name of any helpers in your custom directory you wish to activate. Within the new helper, define your own custom functions that will be available throughout your application.
``` php
if (!function_exists('hello')) {
/**
* say hello
*
* @param string $name
* @return string
*/
function hello($name)
{
return 'Hello ' . $name . '!';
}
}
```
## Change log
Please see [CHANGELOG](CHANGELOG.md) for more information what has changed recently.
## Testing
``` bash
$ composer test
```
## Contributing
Please see [CONTRIBUTING](CONTRIBUTING.md) and [CONDUCT](CONDUCT.md) for details.
## Security
If you discover any security related issues, please email [email protected] instead of using the issue tracker.
## Credits
- [Andrew Brown][link-author]
- [All Contributors][link-contributors]
## License
The MIT License (MIT). Please see [License File](LICENSE.md) for more information.
[ico-version]: https://img.shields.io/packagist/v/browner12/helpers.svg?style=flat-square
[ico-license]: https://img.shields.io/badge/license-MIT-brightgreen.svg?style=flat-square
[ico-travis]: https://img.shields.io/travis/browner12/helpers/master.svg?style=flat-square
[ico-scrutinizer]: https://img.shields.io/scrutinizer/coverage/g/browner12/helpers.svg?style=flat-square
[ico-code-quality]: https://img.shields.io/scrutinizer/g/browner12/helpers.svg?style=flat-square
[ico-downloads]: https://img.shields.io/packagist/dt/browner12/helpers.svg?style=flat-square
[link-packagist]: https://packagist.org/packages/browner12/helpers
[link-travis]: https://travis-ci.org/browner12/helpers
[link-scrutinizer]: https://scrutinizer-ci.com/g/browner12/helpers/code-structure
[link-code-quality]: https://scrutinizer-ci.com/g/browner12/helpers
[link-downloads]: https://packagist.org/packages/browner12/helpers
[link-author]: https://github.com/browner12
[link-contributors]: ../../contributors