Laravel is a really cool framework. But there is always some improvements that can be made. This repository is like beta sandbox for it, before a potential pull requests on the official laravel git.

This library comes with some useful standalone classes:

• Pagination\ByOffsetLengthAwarePaginator (todo...)

• GPS\GPSCoordinates (todo...)

• Selectors\Selector (todo...)

• Services\Service (todo...)

• Validation\Validator (todo...)

(todo...)

• createProgressBar($nbLines)

(todo...)

• advanceProgressBar($nbLinesMoved = 1)

(todo...)

• hasActiveProgressBar()

(todo...)

• finishProgressBar()

(todo...)

• info($message, $verbosity = null, $tab = 0)

(todo...)

• comment($message, $verbosity = null, $tab = 0)

(todo...)

• error($message, $verbosity = null, $tab = 0)

(todo...)

This class inherits directly from Illuminate\Database\Eloquent\Model but add some features, specifically about relations management.

Implements the CollectionOrModel interface.

• static table()

Allows the usage of getTable() statically.

• static tableColumn($column)

Allows the usage of getTableColumn() statically.

• getTableColumn($column)

Alias for qualifyColumn($column) which has been added since.

• newEloquentBuilder($query)

This method has been overwritten to return a Jchedev\Laravel\Eloquent\Builders\Builder instead. If you decide to use your own Builder class, you should make it inherits from Jchedev\Laravel\Eloquent\Builders\Builder first.

• newCollection(array $models = [])

This method has been overwritten to return a Jchedev\Laravel\Eloquent\Collections\Collection instead. If you decide to return your own Collection class, you should make it inherits from Jchedev\Laravel\Eloquent\Collections\Collection first.

This class inherits directly from Illuminate\Database\Eloquent\Collection but add new methods.

Implements the CollectionOrModel interface.

• builder()

Returns a builder targeting only the items of the collection (using whereIn(primary_key, [...])). This method expects all the items of the collection to be from the same Model (Mixing some "Users" to some "Comments" will create unwanted behavior).

• update(array $attributes = [], array $options = [])

Run an update query on the builder returned by builder().

• delete(array $options = [])

Run an delete query on the builder returned by builder().

This class inherits directly from Illuminate\Database\Eloquent\Builder but add new methods.

• addSelectThroughRelation($relationName, $fields)

(todo...)

• joinThroughRelation($relationName, $type = 'inner')

(todo...)

• countWithLimit($columns = '*')

With the existing implementation of the count() method, the limit parameters is ignored. This method changes that.

Example with a total of 200 users:
User::take(10)->count() =  200
User::take(10)->countWithLimit() = 10

• chunkWithLimit($count, callable $callback, $limit = null)

(todo...)

• select($columns = ['*'])

The default select() method is not qualifying the column name. This one is.

• where($column, $operator = null, $value = null, $boolean = 'and')

The default where() method is not qualifying the column name. This one is.

• whereNull($column, $boolean = 'and', $not = false)

The default whereNull() method is not qualifying the column name. This one is.

• whereIn($column, $values, $boolean = 'and', $not = false)

The default whereIn() method is not qualifying the column name. This one is.

• whereIs($value, $boolean = 'and', $not = false)

(todo...)

• whereBetween($column, array $values, $boolean = 'and', $not = false)

The default whereBetween() method is not qualifying the column name. This one is.

This library comes with some extra exceptions:

• UnexpectedClassException (todo...)

This library comes with some extra middleware:

• AuthNotRequired (todo...)

• LogQueries (todo...)

• MinifiedResponse (todo...)

Calling a method that doesnt exist on the object will automatically forward the call to each Resource element.

Calling ::collection() will return a Jchedev\Laravel\Http\Resources\Collection object.

This library comes with some extra rules:

• HandlesExceptions

• HasCompositePrimaryKey

• HasGPSCoordinates

• HasReference

This library comes with some useful helpers:

• array_get_any(array $array, array $keys, $default = null) (todo...)

• get_variable_type($variable) The default gettype() method doesnt work if a Closure. This method does.

• get_class_basename($object): Accept a string or an object and return only the basename part of a get_class() return on it. (Example: get_class_basename('Jchedev\Laravel\Console\Commands') will return "Commands").

• get_class_namespace($object): Accept a string or an object and return only the namespace part of a get_class() return on it. (Example: get_class_basename('Jchedev\Laravel\Console\Commands') will return "Jchedev\Laravel\Console").

• sanitize_string($value) Trim the string, except if value is NULL.

• boolean_to_string($value, $true = 'true', $false = 'false'): Converts a boolean true/false into a string (Default values: "true" or "false").

• null_if_empty($value): Check if a string is empty and return NULL if so.

• time_duration($string, $convert_in = 'second'): Converts a readable string ("2 weeks", "1 month") into a number (based on $convert_in which accepts: "second", "minute", "hour", "day", "month", "year").

• time_multiplier($from, $to): Return the time ratio between $from and $to. (Example: time_multiplier('minute', 'second') will returns 60 since there is 60 seconds in 1 minute.

• table_column($table, $column): Appends a $table name to a $column. This helper is mainly used by the query builder.

• minify_html($html): Minify as much as possible some html content by removing unecessary tabs, comments and such and return the optimized string.