Readouble

Laravel 4.2 クエリービルダー

イントロダクションIntroduction

データベースクエリービルダーは便利で、スラスラと書ける(fluent)インターフェイスで、クエリーを作成し、実行することができます。アプリケーションで行われるデーターベース操作のほとんどが可能で、サポートしているデータベースシステム全部に対して使用できます。The database query builder provides a convenient, fluent interface to creating and running database queries. It can be used to perform most database operations in your application, and works on all supported database systems.

**注意:**Laravelのクエリービルダーは、アプリケーションをSQLインジェクション攻撃から守るために、PDOパラメーターによるバインディングを使用します。バインドする文字列をクリーンにしてから渡す必要はありません。Note: The Laravel query builder uses PDO parameter binding throughout to protect your application against SQL injection attacks. There is no need to clean strings being passed as bindings.

SELECTSelects

テーブルから全レコードを取得するRetrieving All Rows From A Table

$users = DB::table('users')->get();

foreach ($users as $user)
{
	var_dump($user->name);
}

テーブルから1レコードを取得するRetrieving A Single Row From A Table

$user = DB::table('users')->where('name', 'John')->first();

var_dump($user->name);

レコードの1カラムを取得するRetrieving A Single Column From A Row

$name = DB::table('users')->where('name', 'John')->pluck('name');

カラム値のリストを取得するRetrieving A List Of Column Values

$roles = DB::table('roles')->lists('title');

このメソッド使用例ではroleのタイトルの配列がリターンされます。返される配列のキーカラムを指定することもできます。This method will return an array of role titles. You may also specify a custom key column for the returned array:

$roles = DB::table('roles')->lists('title', 'name');

SELECT節を指定するSpecifying A Select Clause

$users = DB::table('users')->select('name', 'email')->get();

$users = DB::table('users')->distinct()->get();

$users = DB::table('users')->select('name as user_name')->get();

存在するクエリーにSELECT節を追加するAdding A Select Clause To An Existing Query

$query = DB::table('users')->select('name');

$users = $query->addSelect('age')->get();

WHERE節を使用するUsing Where Operators

$users = DB::table('users')->where('votes', '>', 100)->get();

OR文Or Statements

$users = DB::table('users')
                    ->where('votes', '>', 100)
                    ->orWhere('name', 'John')
                    ->get();

WHERE BETWEENUsing Where Between

$users = DB::table('users')
                    ->whereBetween('votes', array(1, 100))->get();

WHERE NOT BETWEENの使用Using Where Not Between

$users = DB::table('users')
                    ->whereNotBetween('votes', array(1, 100))->get();

配列でWHERE INを使用するUsing Where In With An Array

$users = DB::table('users')
                    ->whereIn('id', array(1, 2, 3))->get();

$users = DB::table('users')
                    ->whereNotIn('id', array(1, 2, 3))->get();

値が設定されていないレコードを見つけるためWHERE NULLを使用するUsing Where Null To Find Records With Unset Values

$users = DB::table('users')
                    ->whereNull('updated_at')->get();

ORDER BY、GROUP BY、HAVINGOrder By, Group By, And Having

$users = DB::table('users')
                    ->orderBy('name', 'desc')
                    ->groupBy('count')
                    ->having('count', '>', 100)
                    ->get();

OFFSETとLIMITOffset & Limit

$users = DB::table('users')->skip(10)->take(5)->get();

JOINJoins

クエリービルダーはJOIN文を書くためにも使用できます。以下の例をご覧ください。The query builder may also be used to write join statements. Take a look at the following examples:

基本的なJOIN文Basic Join Statement

DB::table('users')
            ->join('contacts', 'users.id', '=', 'contacts.user_id')
            ->join('orders', 'users.id', '=', 'orders.user_id')
            ->select('users.id', 'contacts.phone', 'orders.price')
            ->get();

LEFT JOIN文Left Join Statement

DB::table('users')
	    ->leftJoin('posts', 'users.id', '=', 'posts.user_id')
	    ->get();

もっと複雑なJOIN節も指定できます。You may also specify more advanced join clauses:

DB::table('users')
        ->join('contacts', function($join)
        {
        	$join->on('users.id', '=', 'contacts.user_id')->orOn(...);
        })
        ->get();

JOINに"where"節を使用したい場合は、joinの中でwhereorWhereを使用して下さい。2つのカラムを比べる代わりに、これらのメソッドは値に対してカラムを比較します。If you would like to use a "where" style clause on your joins, you may use the where and orWhere methods on a join. Instead of comparing two columns, these methods will compare the column against a value:

DB::table('users')
        ->join('contacts', function($join)
        {
        	$join->on('users.id', '=', 'contacts.user_id')
        	     ->where('contacts.user_id', '>', 5);
        })
        ->get();

WHEREAdvanced Wheres

パラメーターのグループ化Parameter Grouping

時々、"where exists"とかネストしたグループ分けのような、更に上級なSQL文を生成する必要があるでしょう。Laravelのクエリービルダーで上手く処理できます。Sometimes you may need to create more advanced where clauses such as "where exists" or nested parameter groupings. The Laravel query builder can handle these as well:

DB::table('users')
            ->where('name', '=', 'John')
            ->orWhere(function($query)
            {
            	$query->where('votes', '>', 100)
            	      ->where('title', '<>', 'Admin');
            })
            ->get();

クエリービルダーは以下のSQLを作成します。The query above will produce the following SQL:

select * from users where name = 'John' or (votes > 100 and title <> 'Admin')

EXISTS文Exists Statements

DB::table('users')
            ->whereExists(function($query)
            {
            	$query->select(DB::raw(1))
            	      ->from('orders')
            	      ->whereRaw('orders.user_id = users.id');
            })
            ->get();

クエリービルダーは以下のSQLを作成します。The query above will produce the following SQL:

select * from users
where exists (
	select 1 from orders where orders.user_id = users.id
)

集計Aggregates

また、クエリービルダーはcountmaxminavgsumなど多くの集計メソッドを提供しています。The query builder also provides a variety of aggregate methods, such as count, max, min, avg, and sum.

集計メソッドを使用するUsing Aggregate Methods

$users = DB::table('users')->count();

$price = DB::table('orders')->max('price');

$price = DB::table('orders')->min('price');

$price = DB::table('orders')->avg('price');

$total = DB::table('users')->sum('votes');

直接SQL文を使用するRaw Expressions

時々、クエリーの中でSQLを直接使用したい場合も起きます。このようなSQLは文字をそのまま埋め込みますから、SQLインジェクションをされないように気をつけてください!エスケープなしのSQLを使用する場合はDB::rawメソッドを使用します。Sometimes you may need to use a raw expression in a query. These expressions will be injected into the query as strings, so be careful not to create any SQL injection points! To create a raw expression, you may use the DB::raw method:

SQLを直接使用するUsing A Raw Expression

$users = DB::table('users')
                     ->select(DB::raw('count(*) as user_count, status'))
                     ->where('status', '<>', 1)
                     ->groupBy('status')
                     ->get();

INSERTInserts

テーブルにレコードを挿入するInserting Records Into A Table

DB::table('users')->insert(
	array('email' => 'john@example.com', 'votes' => 0)
);

テーブルにレコードを挿入し、自動増加したIDを取得するInserting Records Into A Table With An Auto-Incrementing ID

テーブルに自動増分IDがある場合はinsertGetIdを使い、レコードを挿入し、そのIDを取得してください。If the table has an auto-incrementing id, use insertGetId to insert a record and retrieve the id:

$id = DB::table('users')->insertGetId(
	array('email' => 'john@example.com', 'votes' => 0)
);

**注目:**PostgreSQLにinsertGetIdメソッドを使用するときには、自動増分カラムの名前は"id"にしてください。Note: When using PostgreSQL the insertGetId method expects the auto-incrementing column to be named "id".

テーブルに複数のレコードを挿入するInserting Multiple Records Into A Table

DB::table('users')->insert(array(
	array('email' => 'taylor@example.com', 'votes' => 0),
	array('email' => 'dayle@example.com', 'votes' => 0),
));

UPDATEUpdates

テーブルのレコードを更新するUpdating Records In A Table

DB::table('users')
            ->where('id', 1)
            ->update(array('votes' => 1));

カラムの値を増加/減少させるIncrementing or decrementing a value of a column

DB::table('users')->increment('votes');

DB::table('users')->increment('votes', 5);

DB::table('users')->decrement('votes');

DB::table('users')->decrement('votes', 5);

更に更新する追加のカラムも指定できます。You may also specify additional columns to update:

DB::table('users')->increment('votes', 1, array('name' => 'John'));

DELETEDeletes

テーブルのレコードを削除するDeleting Records In A Table

DB::table('users')->where('votes', '<', 100)->delete();

テーブルから全レコードを削除するDeleting All Records From A Table

DB::table('users')->delete();

テーブルをTRUNCATEするTruncating A Table

DB::table('users')->truncate();

クエリー結合Unions

クエリービルダーは2つのクエリーを結合(union)させる手軽な手法を提供します。The query builder also provides a quick way to "union" two queries together:

$first = DB::table('users')->whereNull('first_name');

$users = DB::table('users')->whereNull('last_name')->union($first)->get();

unionAllメソッドも使用でき、unionと同じ使い方をします。The unionAll method is also available, and has the same method signature as union.

排他的ロックPessimistic Locking

クエリービルダーは、SELECT文で排他的ロックを行うための機能を多少持っています。The query builder includes a few functions to help you do "pessimistic locking" on your SELECT statements.

「共有ロック」でSELECT文を実行する場合は、sharedLockメソッドをクエリーで指定して下さい。To run the SELECT statement with a "shared lock", you may use the sharedLock method on a query:

DB::table('users')->where('votes', '>', 100)->sharedLock()->get();

SELECT文を「専有ロック」で実行したい場合は、lockForUpdateメソッドをクエリーに使用します。To "lock for update" on a SELECT statement, you may use the lockForUpdate method on a query:

DB::table('users')->where('votes', '>', 100)->lockForUpdate()->get();

クエリーのキャッシュCaching Queries

rememberrememberForeverを使用して、クエリー結果を簡単にキャッシュできます。You may easily cache the results of a query using the remember or rememberForever method:

$users = DB::table('users')->remember(10)->get();

この例では、クエリー結果は10分間キャッシュされます。その間、結果はキャッシュされ、データベースに対してそのクエリーは実行されません。結果はアプリケーションに指定されているデフォルトキャッシュドライバーからロードされます。In this example, the results of the query will be cached for ten minutes. While the results are cached, the query will not be run against the database, and the results will be loaded from the default cache driver specified for your application.

サポートされているキャッシュドライバーを使用している場合、タグをキャッシュすることも可能です。If you are using a supported cache driver[/docs/4.2/cache#cache-tags], you can also add tags to the caches:

$users = DB::table('users')->cacheTags(array('people', 'authors'))->remember(10)->get();

章選択

Artisan CLI

設定

明暗テーマ
light_mode
dark_mode
brightness_auto システム設定に合わせる
テーマ選択
photo_size_select_actual デフォルト
photo_size_select_actual モノクローム(白黒)
photo_size_select_actual Solarized風
photo_size_select_actual GitHub風(青ベース)
photo_size_select_actual Viva(黄緑ベース)
photo_size_select_actual Happy(紫ベース)
photo_size_select_actual Mint(緑ベース)
コードハイライトテーマ選択

明暗テーマごとに、コードハイライトのテーマを指定できます。

テーマ配色確認
スクリーン表示幅
640px
80%
90%
100%

768px以上の幅があるときのドキュメント部分表示幅です。

インデント
無し
1rem
2rem
3rem
原文確認
原文を全行表示
原文を一行ずつ表示
使用しない

※ 段落末のEボタンへカーソルオンで原文をPopupします。

Diff表示形式
色分けのみで区別
行頭の±で区別
削除線と追記で区別

※ [tl!…]形式の挿入削除行の表示形式です。

テストコード表示
両コード表示
Pestのみ表示
PHPUnitのみ表示
和文変換

対象文字列と置換文字列を半角スペースで区切ってください。(最大5組各10文字まで)

本文フォント

総称名以外はCSSと同様に、"〜"でエスケープしてください。

コードフォント

総称名以外はCSSと同様に、"〜"でエスケープしてください。

保存内容リセット

localStrageに保存してある設定項目をすべて削除し、デフォルト状態へ戻します。

ヘッダー項目移動

キーボード操作