Laravel MySQLite is meant to be used in conjunction with Laravel. It is a database connection that adds select functions from MySQL to SQLite.
- Execute
composer require spam-n-eggs/laravel-mysqlite
or alternativelycomposer require --dev spam-n-eggs/laravel-mysqlite
In order to reduce clutter it is preferable to create a separate Service Provider
-
If there is a need to conditionally register the Service (i.e. you only use it in testing) create a new class in
app/Providers
that extendsMhorninger\SQLite\MySQLiteServiceProvider
<?php namespace App\Providers; use Mhorninger\SQLite\MySQLiteServiceProvider as ServiceProvider; class MySQLiteServiceProvider extends ServiceProvider { public function register() { if ($shouldRegister) { parent::register(); } } }
-
Add a line to
app/Providers/AppServiceProvider.php
within theregister()
method:$this->app->register(MySQLiteServiceProvider::class);
- convert_tz(date, fromTimezone, toTimezone)
- date_add(date, INTERVAL <number_of> <interval_specifier>)
- Ported Interval Specifiers
- SECOND
- MINUTE
- HOUR
- DAY
- WEEK
- MONTH
- YEAR
- Differences
- All DATE_ADD calls bring back the entire date time as opposed to just the short date.
- Ported Interval Specifiers
- date_format(date, format)
- Un-ported Format Strings:
%U
,%V
,%X
- Other Limitations:
%j
is off by 1 day.
- Un-ported Format Strings:
- hour(time)
- minute(time)
- now()
- timestampdiff(timeUnit, startTimeStamp, endTimeStamp)
- time_to_sec(timeExpression)
- timediff(timeExpression1, timeExpression2)
- to_days(date)
- unix_timestamp(date = null)
- utc_timestamp()
- weekday(date)
- mod(number, divisor)
- Limitations - Support for Standard
MOD(N,M)
andN % M
notation only.N MOD M
is not supported.
- Limitations - Support for Standard
- rand()
- sqrt(value)
- concat(string ...)
- concat_ws(separator, string ...)
- format(number, decimals, locale = 'en_US')
- lpad(string, length, pad)
- rpad(string, length, pad)
- left(string, length)
- right(string, length)
While this package aims to cover common functionality, there are times when you need support for a function quickly or a custom function that is unique to your application. This is easy to do with two methods from the boot()
method of your service provider class:
<?php
class MySQLiteServiceProvider extends ServiceProvider
{
...
public function boot()
{
$connection = $this->app->get('db')->connection();
if ($connection->getDriverName() === 'sqlite') {
$connection
->addRewriteRule('/CURDATE\(\)/', "date('now')")
->addFunction('CURDATE', fn() => CarbonImmutable::today()->toDateString(), 0);
}
}
}
addRewriteRule()
will replace a string in your query using regex, should Sqlite have a native function that could be used as a 1:1 replacement.addFunction()
uses PDOsqliteCreateFunction()
to register a custom function with PHP in the event that Sqlite doesn't have a drop-in replacement or if logic is more complicated. Read More.
Want to file a bug, contribute some code, improve documentation, or request a feature? Awesome Sauce! Read up on our guidelines for contributing. All contributions must follow our Code of Conduct.
Have a question? Log an issue with the Question tag. We'll get back to you in a timely fashion.
This library uses other Open Source components. You can find the source code of their open source projects along with license information below. We acknowledge and are grateful to these developers for their contributions to open source community.
Project: Database https://github.com/illuminate/database Copyright (c) Taylor Otwell License (MIT) https://github.com/laravel/framework/blob/5.7/LICENSE.md
Project: MySQLite https://github.com/Vectorface/MySQLite Copyright (c) 2014 Vectorface, Inc. License: (MIT) https://github.com/Vectorface/MySQLite/blob/master/LICENSE