calebporzio / awesome-helpers
Helper functions I find super-duper handy
Installs: 99 016
Dependents: 1
Suggesters: 0
Security: 0
Stars: 629
Watchers: 13
Forks: 49
Open Issues: 11
Requires
- php: >=7.3
Requires (Dev)
- fakerphp/faker: ^1.12
- illuminate/support: 5.7.*|5.8.*|^6.0|^7.0|^8.0
- mockery/mockery: dev-master
- phpunit/phpunit: ^8.0|^9.0
README
Installation
composer require calebporzio/awesome-helpers
Helpers
carbon
Shortcut for: new Carbon
or Carbon::parse()
carbon('One year ago');
chain
Makes an ordinary object chainable.
chain(new SomeClass) ->firstMethod() ->secondMethod() ->thirdMethod(); // You can use the "carry" constant to pass the result of one method into the other: chain(new Str)->singular('cars')->ucfirst(carry)(); // Returns "Car" // Also, you can grab the result of the chain by trailing // a "()" on the end of it. (Thanks to Taylor Otwell for these two additions)
connection
Run callback under a different database connection.
$tenantPostIds = connection('tenantdb', function () { return Post::pluck('id'); });
dump_sql
Returns sql query with bindings data.
dump_sql(\DB::table('users')->where('email', "blaBla")->where('id', 1)); // returns "select * from `users` where `email` = 'blaBla' and `id` = 1"
faker
Shortcut for: $faker = Faker\Factory::create()
faker()->address; // returns random, fake address faker('address'); // alternate syntax
user
A shortcut for auth()->user()
user()->posts()->create([...]);
money
echo money(12); // echoes "$12.00" echo money(12.75); // echoes "$12.75" echo money(12.75, false); // echos "$13" echo money(12.75, true, 'en_GB'); // echos "£12.75" // Note: unless specified otherwise, money() will detect the current locale.
ok
Shortcut for response('', 204)
. When you don't have anything to return from an endpoint, but you want to return success.
return ok();
stopwatch
Returns the amount of time (in seconds) the provided callback took to execute. Useful for debugging and profiling.
stopwatch(function () { sleep(2); }); // returns "2.0"
str_between
Returns string between second argument
str_between('--thing--', '--'); // returns "thing" str_between('[thing]', '[', ']'); // returns "thing" Str::between('--thing--', '--'); // returns "thing" Str::between('[thing]', '[', ']'); // returns "thing"
str_extract
Returns capture groups contained in the provided regex pattern.
str_extract('Jan-01-2019', '/Jan-(.*)-2019/'); // returns "01" Str::extract('Jan-01-2019', '/Jan-(.*)-2019/'); // returns "01"
str_match
Checks the provided string against the provided regex pattern.
str_match('Jan-01-2019', '/Jan-.*-2019/'); // returns true str_match('foo bar baz', 'bar'); // returns true Str::match('Jan-1-2019', '/Jan-(.*)-2019/'); // returns true
str_validate
A simple way to use validate a string using Laravel's built-in validation system.
str_validate('calebporzio@aol.com', 'regex:/\.net$/|email|max:10'); // returns: ["Format is invalid.", "May not be greater than 10 characters."] Str::validate('calebporzio@aol.com', 'regex:/\.net$/|email|max:10'); // returns: ["Format is invalid.", "May not be greater than 10 characters."]
str_wrap
str_wrap('thing', '--'); // returns "--thing--" Str::wrap('thing', '--'); // returns "--thing--"
swap
This function swaps the values of two variables.
$startDate = '2040-01-01'; $endDate = '2020-01-01'; if ($endDate < $startDate) { swap($startDate, $endDate); } echo $startDate; // prints "2020-01-01" echo $endDate; // prints "2040-01-01"
tinker
Kind of like dd()
, but will open an artisan tinker
terminal session with the variables you passed in, so you can play around.
$somethingYouWantToDebug = new StdClass; tinker($somethingYouWantToDebug);
Am I missing an awesome helper function?
Submit a PR or issue with helper functions you use or ideas you have for others!
TTFN, Caleb