Changed the client id from integer to varchar as per #6, updated the configuration documentation as suggested in #7

Author: Luca Degasperi

src/config/oauth2.php

@@ -9,19 +9,26 @@
     |
     | Your OAuth2 Server can issue an access token based on different grant types
     | you can even provide your own grant type.
+    | To choose which grant type suits your scenario, see
+    | https://github.com/php-loep/oauth2-server/wiki/Which-OAuth-2.0-grant-should-I-use%3F
+    |
     | Available grant types are:
     | 
     | 'grant_types' => array(
     |
     |    'authorization_code' => array(
     |        'class'            => 'League\OAuth2\Server\Grant\AuthCode',
     |        'access_token_ttl' => 3600,
+    |
+    |        // the authorization code time to live
     |        'auth_token_ttl'   => 3600,
     |    ),
     |
     |    'password' => array(
     |        'class'            => 'League\OAuth2\Server\Grant\Password',
     |        'access_token_ttl' => 604800,
+    |
+    |        // the code to run in order to verify the user's identity
     |        'callback'         => function($username, $password){
     |            
     |            return Auth::validate(array(
@@ -31,16 +38,26 @@
     |        }
     |    ),
     |
+    |    'client_credentials' => array(
+    |        'class'                 => 'League\OAuth2\Server\Grant\ClientCredentials',
+    |        'access_token_ttl'      => 3600,
+    |    ),
+    |
     |    'refresh_token' => array(
     |        'class'                 => 'League\OAuth2\Server\Grant\RefreshToken',
     |        'access_token_ttl'      => 3600,
+    |
+    |        // the refresh token time to live
     |        'refresh_token_ttl'     => 604800,
+    |
+    |        // whether or not to issue a new refresh token when a new access token is issued
     |        'rotate_refresh_tokens' => false,
     |    ),
     |    
     | ),
     |
     */
+
     'grant_types' => array(
 
         'authorization_code' => array(
@@ -116,16 +133,52 @@
     |--------------------------------------------------------------------------
     |
     | For how long the issued access token is valid (in seconds)
+    | this can be also set on a per grant-type basis
     |
     */
     'access_token_ttl' => 3600,
 
-
+    /*
+    |--------------------------------------------------------------------------
+    | Limit clients to specific grants
+    |--------------------------------------------------------------------------
+    |
+    | Whether or not to limit clients to specific grant types
+    | This is useful to allow only trusted clients to access your API differently
+    |
+    */
     'limit_clients_to_grants' => false,
 
+    /*
+    |--------------------------------------------------------------------------
+    | Limit clients to specific scopes
+    |--------------------------------------------------------------------------
+    |
+    | Whether or not to limit clients to specific scopes
+    | This is useful to only allow specific clients to use some scopes
+    |
+    */
     'limit_clients_to_scopes' => false,
 
+    /*
+    |--------------------------------------------------------------------------
+    | Limit scopes to specific grants
+    |--------------------------------------------------------------------------
+    |
+    | Whether or not to limit scopes to specific grants
+    | This is useful to allow certain scopes to be used only with certain grant types
+    |
+    */
     'limit_scopes_to_grants' => false,
 
+    /*
+    |--------------------------------------------------------------------------
+    | HTTP Header Only
+    |--------------------------------------------------------------------------
+    |
+    | This will tell the resource server where to check for the access_token.
+    | By default it checks both the query string and the http headers
+    |
+    */
     'http_headers_only' => false,
 );

src/migrations/2013_07_24_132419_create_oauth_clients_table.php

@@ -13,12 +13,13 @@ class CreateOAuthClientsTable extends Migration {
 	public function up()
 	{
 		Schema::create('oauth_clients', function(Blueprint $table) {
-            $table->increments('id');
+            $table->string('id', 40);
             $table->string('secret', 40);
             $table->string('name');
             $table->boolean('auto_approve')->default(false);
             $table->timestamps();
 
+            $table->unique('id');
             $table->unique(array('id', 'secret'));
         });
 	}

src/migrations/2013_07_24_133032_create_oauth_client_endpoints_table.php

@@ -14,7 +14,7 @@ public function up()
 	{
 		Schema::create('oauth_client_endpoints', function(Blueprint $table) {
             $table->increments('id');
-            $table->integer('client_id')->unsigned();
+            $table->string('client_id', 40);
             $table->string('redirect_uri');
 
             $table->timestamps();

src/migrations/2013_07_24_133359_create_oauth_sessions_table.php

@@ -14,7 +14,7 @@ public function up()
 	{
 		Schema::create('oauth_sessions', function(Blueprint $table) {
             $table->increments('id');
-            $table->integer('client_id')->unsigned();
+            $table->string('client_id', 40);
             $table->enum('owner_type', array('client', 'user'))->default('user');
             $table->string('owner_id');
             $table->timestamps();

src/migrations/2013_07_24_134700_create_oauth_session_refresh_tokens_table.php

@@ -17,7 +17,7 @@ public function up()
             $table->integer('session_access_token_id')->unsigned()->primary();
             $table->string('refresh_token', 40);
             $table->integer('refresh_token_expires');
-            $table->integer('client_id')->unsigned();
+            $table->string('client_id', 40);
 
             $table->timestamps();
 

src/migrations/2013_08_07_112252_create_oauth_client_grants_table.php

@@ -14,7 +14,7 @@ public function up()
 	{
 		Schema::create('oauth_client_grants', function(Blueprint $table) {
 			$table->increments('id');
-			$table->integer('client_id')->unsigned();
+			$table->string('client_id', 40);
             $table->integer('grant_id')->unsigned();
 			$table->timestamps();
 

src/migrations/2013_08_07_183251_create_oauth_client_scopes_table.php

@@ -14,7 +14,7 @@ public function up()
 	{
 		Schema::create('oauth_client_scopes', function(Blueprint $table) {
 			$table->increments('id');
-			$table->integer('client_id')->unsigned();
+			$table->string('client_id', 40);
             $table->integer('scope_id')->unsigned();
 
 			$table->foreign('client_id')