🎉 initial commit

Author: michaeldyrynda

.gitignore

@@ -0,0 +1,2 @@
+/vendor
+composer.lock

.travis.yml

@@ -0,0 +1,30 @@
+language: php
+
+php:
+  - '5.6.4'
+  - '7.0'
+  - '7.1'
+
+env:
+  - ILLUMINATE_VERSION=5.4.*
+
+matrix:
+  include:
+    - php: 5.6.4
+      env: ILLUMINATE_VERSION=5.4.*
+    - php: 7.0
+      env: ILLUMINATE_VERSION=5.4.*
+    - php: 7.1
+      env: ILLUMINATE_VERSION=5.4.*
+
+before_install:
+  - composer require "illuminate/database:${ILLUMINATE_VERSION}" --no-update -v
+  - composer require "illuminate/events:${ILLUMINATE_VERSION}" --no-update -v
+
+install: composer update --prefer-source --no-interaction --dev -v
+
+script: vendor/bin/phpunit --debug -c phpunit.xml --coverage-clover=coverage.clover
+
+after_script:
+    - wget https://scrutinizer-ci.com/ocular.phar
+    - php ocular.phar code-coverage:upload --format=php-clover coverage.clover

LICENSE.txt

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2017 Michael Dyrynda
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

README.md

@@ -0,0 +1,56 @@
+# Laravel Efficient UUIDs
+## v1.0.0
+
+[![Build Status](https://travis-ci.org/michaeldyrynda/laravel-efficient-uuid.svg?branch=master)](https://travis-ci.org/michaeldyrynda/laravel-efficient-uuid)
+[![Scrutinizer Code Quality](https://scrutinizer-ci.com/g/michaeldyrynda/laravel-efficient-uuid/badges/quality-score.png?b=master)](https://scrutinizer-ci.com/g/michaeldyrynda/laravel-efficient-uuid/?branch=master)
+[![Code Coverage](https://scrutinizer-ci.com/g/michaeldyrynda/laravel-efficient-uuid/badges/coverage.png?b=master)](https://scrutinizer-ci.com/g/michaeldyrynda/laravel-efficient-uuid/?branch=master)
+[![Latest Stable Version](https://poser.pugx.org/dyrynda/laravel-efficient-uuid/v/stable)](https://packagist.org/packages/dyrynda/laravel-efficient-uuid)
+[![Total Downloads](https://poser.pugx.org/dyrynda/laravel-efficient-uuid/downloads)](https://packagist.org/packages/dyrynda/laravel-efficient-uuid)
+[![License](https://poser.pugx.org/dyrynda/laravel-efficient-uuid/license)](https://packagist.org/packages/dyrynda/laravel-efficient-uuid)
+
+## Introduction
+
+This package simply overrides the default grammar file for the given connection making the `uuid()` blueprint method return a `binary(16)` rather than the default `char(36)`.
+
+MySQL is the only supported connection type, only because I've no experience with other drivers. I welcome any pull requests to implement this functionality for other database drivers.
+
+For more information, check out [this post](https://www.percona.com/blog/2014/12/19/store-uuid-optimized-way/) on storing and working with UUID in an optimised manner.
+
+Using UUIDs in Laravel is made super simple in combination with [laravel-model-uuid](https://github.com/michaeldyrynda/laravel-model-uuid).
+
+## Installation
+
+This package is installed via [Composer](https://getcomposer.org/). To install, run the following command.
+
+```bash
+composer require dyrynda/laravel-efficient-uuid
+```
+
+Register the service provider in your `config/app.php` configuration file:
+
+```php
+'providers' => [
+    ...
+    Dyrynda\Database\LaravelEfficientUuidServiceProvider::class,
+],
+```
+
+There is nothing special needed for this to function, simply declare a `uuid` column type in your migration files.
+
+```php
+Schema::create('posts', function (Blueprint $table) {
+    $table->increments('id');
+    $table->uuid('uuid')->index();
+    $table->string('title');
+    $table->text('body');
+    $table->timestamps();
+});
+```
+
+## Support
+
+If you are having general issues with this package, feel free to contact me on [Twitter](https://twitter.com/michaeldyrynda).
+
+If you believe you have found an issue, please report it using the [GitHub issue tracker](https://github.com/michaeldyrynda/laravel-efficient-uuid/issues), or better yet, fork the repository and submit a pull request.
+
+If you're using this package, I'd love to hear your thoughts. Thanks!

composer.json

@@ -0,0 +1,33 @@
+{
+  "name": "dyrynda/laravel-efficient-uuid",
+  "description": "A package to override Laravel migrations to more efficiently store UUID fields in your database",
+  "type": "utility",
+  "require": {
+    "php": ">=5.6.4",
+    "illuminate/container": "5.4.*",
+    "illuminate/database": "5.4.*"
+  },
+  "require-dev": {
+    "phpunit/phpunit": "~5.7",
+    "mockery/mockery": "~0.9.4"
+  },
+  "autoload": {
+    "psr-4": {
+      "Dyrynda\\Database\\": "src/"
+    }
+  },
+  "autoload-dev": {
+    "psr-4": {
+      "Tests\\": "tests/"
+    }
+  },
+  "license": "MIT",
+  "authors": [
+    {
+      "name": "Michael Dyrynda",
+      "email": "[email protected]",
+      "homepage": "https://dyrynda.com.au"
+    }
+  ],
+  "minimum-stability": "stable"
+}

phpunit.xml

@@ -0,0 +1,21 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<phpunit backupGlobals="false"
+         backupStaticAttributes="false"
+         colors="true"
+         convertErrorsToExceptions="true"
+         convertNoticesToExceptions="true"
+         convertWarningsToExceptions="true"
+         processIsolation="false"
+         stopOnFailure="false"
+         syntaxCheck="false">
+    <testsuites>
+        <testsuite name="Application Test Suite">
+            <directory>./tests/</directory>
+        </testsuite>
+    </testsuites>
+    <filter>
+        <whitelist>
+            <directory suffix=".php">src/</directory>
+        </whitelist>
+    </filter>
+</phpunit>

src/Blueprint.php

@@ -0,0 +1,22 @@
+<?php
+
+namespace Dyrynda\Database;
+
+use Illuminate\Database\Schema\Blueprint as BaseBlueprint;
+
+class Blueprint extends BaseBlueprint
+{
+    /**
+     * Create a new uuid column on the table, of type binary(16)
+     *
+     * @link  https://www.percona.com/blog/2014/12/19/store-uuid-optimized-way/ Store UUID in an optimized way
+     *
+     * @param  string  $column
+     *
+     * @return \Illuminate\Support\Fluent
+     */
+    public function uuid($column)
+    {
+        return $this->addColumn('uuid', $column);
+    }
+}

src/Connection/MySqlConnection.php

@@ -0,0 +1,19 @@
+<?php
+
+namespace Dyrynda\Database\Connection;
+
+use Dyrynda\Database\Schema\Grammars\MySqlGrammar;
+use Illuminate\Database\MySqlConnection as BaseMySqlConnection;
+
+class MySqlConnection extends BaseMySqlConnection
+{
+    /**
+     * Get the default schema grammar instance.
+     *
+     * @return \Illuminate\Database\Grammar
+     */
+    protected function getDefaultSchemaGrammar()
+    {
+        return $this->withTablePrefix(new MySqlGrammar);
+    }
+}

src/LaravelEfficientUuidServiceProvider.php

@@ -0,0 +1,34 @@
+<?php
+
+namespace Dyrynda\Database;
+
+use Dyrynda\Database\Connection\MySqlConnection;
+use Illuminate\Database\Connection;
+use Illuminate\Support\ServiceProvider;
+
+class LaravelEfficientUuidServiceProvider extends ServiceProvider
+{
+
+    /**
+     * Bootstrap any application services.
+     *
+     * @return void
+     */
+    public function boot()
+    {
+        //
+    }
+
+
+    /**
+     * Register any application services.
+     *
+     * @return void
+     */
+    public function register()
+    {
+        Connection::resolverFor('mysql', function ($connection, $database, $prefix, $config) {
+            return new MySqlConnection($connection, $database, $prefix, $config);
+        });
+    }
+}

src/Schema/Grammars/MySqlGrammar.php

@@ -0,0 +1,21 @@
+<?php
+
+namespace Dyrynda\Database\Schema\Grammars;
+
+use Illuminate\Database\Schema\Grammars\MySqlGrammar as BaseMySqlGrammar;
+use Illuminate\Support\Fluent;
+
+class MySqlGrammar extends BaseMySqlGrammar
+{
+    /**
+     * Create the column definition for a UUID type.
+     *
+     * @param  \Illuminate\Support\Fluent  $column
+     *
+     * @return string
+     */
+    protected function typeUuid(Fluent $column)
+    {
+        return sprintf('binary(16)');
+    }
+}