Database - 1. Getting Started

Einführung

Laravel macht die Interaktion mit Datenbanken über eine Vielzahl von Datenbank-Backends hinweg extrem einfach, indem er entweder Raw SQL, den flüssigen Query Builder und das Eloquent ORM verwendet. Derzeit unterstützt Laravel vier Datenbanken:

MySQL
PostgreSQL
SQLite
SQL SERVER

Konfiguration

Die Datenbankkonfiguration für Ihre Anwendung finden Sie unter config/database.php. In dieser Datei können Sie alle Ihre Datenbankverbindungen definieren und festlegen, welche Verbindung standardmäßig verwendet werden soll. Beispiele für die meisten unterstützten Datenbanksysteme finden Sie in dieser Datei.

Standardmäßig ist die Laravel-Beispielumgebungskonfiguration bereit, mit Laravel Homestead verwendet zu werden, einer praktischen virtuellen Maschine, um die Laravel-Entwicklung auf Ihrem lokalen Computer durchzuführen. Sie können diese Konfiguration nach Bedarf für Ihre lokale Datenbank ändern.

SQLite Configuration

Nachdem Sie eine neue SQLite-Datenbank mit einem Befehl wie touch database/database.sqlite erstellt haben, können Sie Ihre Umgebungsvariablen so konfigurieren, dass sie auf diese neu erstellte Datenbank verweisen, indem Sie den absoluten Pfad der Datenbank verwenden:

DB_CONNECTION=sqlite

DB_DATABASE=/absolute/path/to/database.sqlite

Um Fremdschlüsselbeschränkungen für SQLite-Verbindungen zu aktivieren, sollten Sie die Option foreign_key_constraints zu Ihrer Konfigurationsdatei config/database.php hinzufügen:

'sqlite' => [
    // ...
    'foreign_key_constraints' => true,
],

Configuration Using URLs

Normalerweise werden Datenbankverbindungen mit mehreren Konfigurationswerten wie Host, Datenbank, Benutzername, Passwort usw. konfiguriert. Jeder dieser Konfigurationswerte hat seine eigene entsprechende Umgebungsvariable. Das bedeutet, dass Sie bei der Konfiguration Ihrer Datenbankverbindungsinformationen auf einem Produktionsserver mehrere Umgebungsvariablen verwalten müssen.

Einige verwaltete Datenbankanbieter wie Heroku bieten eine einzige Datenbank "URL", die alle Verbindungsinformationen für die Datenbank in einer einzigen Zeichenkette enthält. Eine exemplarische Datenbank-URL kann etwa wie folgt aussehen:

mysql://root:password@127.0.0.1/forge?charset=UTF-8

Diese URLs folgen in der Regel einer Standardschemakonvention:

driver://username:password@host:port/database?options

Laravel unterstützt diese URLs als Alternative zur Konfiguration Ihrer Datenbank mit mehreren Konfigurationsoptionen. Wenn die Konfigurationsoption url (oder die entsprechende Umgebungsvariable DATABASE_URL) vorhanden ist, wird sie verwendet, um die Datenbankverbindung und die Anmeldeinformationen zu extrahieren.

Read & Write Connections

Manchmal möchten Sie eine Datenbankverbindung für SELECT-Anweisungen und eine andere für INSERT-, UPDATE- und DELETE-Anweisungen verwenden. Laravel macht dies zu einem Kinderspiel, und die richtigen Verbindungen werden immer verwendet, unabhängig davon, ob Sie rohe Abfragen, den Query Builder oder das eloquente ORM verwenden.

Um zu sehen, wie Lese-/Schreibverbindungen konfiguriert werden sollten, schauen wir uns dieses Beispiel an:

'mysql' => [
    'read' => [
        'host' => [
            '192.168.1.1',
            '196.168.1.2',
        ],
    ],
    'write' => [
        'host' => [
            '196.168.1.3',
         ],
    ],
    'sticky'    => true,
    'driver'    => 'mysql',
    'database'  => 'database',
    'username'  => 'root',
    'password'  => '',
    'charset'   => 'utf8mb4',
    'collation' => 'utf8mb4_unicode_ci',
    'prefix'    => '',
],

Beachten Sie, dass dem Konfigurations-Array drei Schlüssel hinzugefügt wurden: read, write und sticky. Die read und write keys haben Array-Werte, die einen einzigen key (Schlüssel) enthalten: host. Der Rest der Datenbankoptionen für die read and write connections wird aus dem mysql-Array zusammengeführt.

Sie müssen nur dann Elemente in den read and write - Arrays platzieren, wenn Sie die Werte aus dem Haupt-Array überschreiben möchten. In diesem Fall wird also 192.168.1.1 als Host für die "read"-Verbindung und 192.168.1.3 für die "write"-Verbindung verwendet. Die Datenbank-Anmeldeinformationen, das Präfix, der Zeichensatz und alle anderen Optionen im mysql-Array werden für beide Verbindungen freigegeben.

The sticky Option

Die Option sticky ist ein optionaler Wert, der verwendet werden kann, um das sofortige Lesen von Datensätzen zu ermöglichen, die während des aktuellen Anfragezyklus in die Datenbank geschrieben wurden. Wenn die Sticky-Option aktiviert ist und während des aktuellen Anfragezyklus eine Schreiboperation gegen die Datenbank durchgeführt wurde, verwenden alle weiteren Lesevorgänge die Verbindung "write". Dadurch wird sichergestellt, dass alle während des Anfragezyklus geschriebenen Daten während derselben Anfrage sofort von der Datenbank zurückgelesen werden können. Es liegt an Ihnen zu entscheiden, ob dies das gewünschte Verhalten für Ihre Anwendung ist.

Using Multiple Database Connections

Wenn Sie mehrere Verbindungen (Connections) verwenden, können Sie auf jede Verbindung über die Connection Methode an der DB-Facade zugreifen. Der Name, der an die Connection Methode übergeben wird, sollte einer der in Ihrer Konfigurationsdatei config/database.php aufgeführten Verbindungen entsprechen:

$users = DB::connection('foo')->select(...);

Sie können auch mit der Methode getPdo auf die rohe, zugrunde liegende PDO-Instanz auf einer Verbindungsinstanz zugreifen:

$pdo = DB::connection()->getPdo();

more themes about Database [TaskID] - Click for open

Task

Type Table

Description

<h4>Running Raw SQL Queries</h4>

Nachdem Sie Ihre Datenbankverbindung konfiguriert haben, k&ouml;nnen Sie Abfragen &uuml;ber die DB-Facade ausf&uuml;hren. Die DB-Facade bietet Methoden f&uuml;r jede Art von Abfrage: Select, Update, Insert, Delete und Statement.

<h4>Running A Select Query</h4>

Um eine Basisabfrage auszuf&uuml;hren, k&ouml;nnen Sie die Select-Methode auf der DB-Facade verwenden:

<pre>
<code>&lt;?php

namespace App\Http\Controllers;

use Illuminate\Support\Facades\DB;
use App\Http\Controllers\Controller;

class UserController extends Controller
{
 /**
 * Show a list of all of the application&#39;s users.
 *
 * @return Response
 */
 public function index()
 {
 $users = DB::select(&#39;select * from users where active = ?&#39;, [1]);

return view(&#39;user.index&#39;, [&#39;users&#39; =&gt; $users]);
 }
}</code></pre>

Das erste Argument, das an die Select-Methode &uuml;bergeben wird, ist die raw SQL-Abfrage, w&auml;hrend das zweite Argument alle Parameterbindungen sind, die an die Abfrage gebunden werden m&uuml;ssen. Typischerweise sind dies die Werte der where-Klauselbeschr&auml;nkungen. Die Parameteranbindung bietet Schutz vor SQL-Injektion.

Die Select-Methode gibt immer ein Array mit Ergebnissen zur&uuml;ck. Jedes Ergebnis innerhalb des Arrays ist ein PHP stdClass Objekt, so dass Sie auf die Werte der Ergebnisse zugreifen k&ouml;nnen:

<pre>
<code>foreach ($users as $user) {
 echo $user-&gt;name;
}</code></pre>

<h4>Using Named Bindings</h4>

Anstatt&nbsp; ?&nbsp;&nbsp;zur Darstellung Ihrer Parameterbindungen zu verwenden, k&ouml;nnen Sie eine Abfrage mit benannten Bindungen ausf&uuml;hren:

<pre>
<code>$results = DB::select(&#39;select * from users where id = :id&#39;, [&#39;id&#39; =&gt; 1]);</code></pre>

<h4>Running An Insert Statement</h4>

Um eine insert-Anweisung auszuf&uuml;hren, k&ouml;nnen Sie die insert-Methode an der DB-Facade verwenden. Wie Select nimmt diese Methode die rohe SQL-Abfrage als erstes Argument und Bindings als zweites Argument:

<pre>
<code>$affected = DB::update(&#39;update users set votes = 100 where name = ?&#39;, [&#39;John&#39;]);</code></pre>

<h4>Running A Delete Statement</h4>

Die delete-Methode sollte verwendet werden, um Datens&auml;tze aus der Datenbank zu l&ouml;schen. Wie beim Update wird die Anzahl der betroffenen Zeilen zur&uuml;ckgegeben:

<pre>
<code>$deleted = DB::delete(&#39;delete from users&#39;);</code></pre>

<h4>Running A General Statement</h4>

Einige Datenbankanweisungen geben keinen Wert zur&uuml;ck. F&uuml;r diese Art von Operationen k&ouml;nnen Sie die statement-Methode an der DB-Facade verwenden:

<pre>
<code>DB::statement(&#39;drop table users&#39;);</code></pre>

Code

Running Raw SQL Queries

Nachdem Sie Ihre Datenbankverbindung konfiguriert haben, können Sie Abfragen über die DB-Facade ausführen. Die DB-Facade bietet Methoden für jede Art von Abfrage: Select, Update, Insert, Delete und Statement.

Running A Select Query

Um eine Basisabfrage auszuführen, können Sie die Select-Methode auf der DB-Facade verwenden:

<?php

namespace App\Http\Controllers;

use Illuminate\Support\Facades\DB;
use App\Http\Controllers\Controller;

class UserController extends Controller
{
    /**
     * Show a list of all of the application's users.
     *
     * @return Response
     */
    public function index()
    {
        $users = DB::select('select * from users where active = ?', [1]);

        return view('user.index', ['users' => $users]);
    }
}

Das erste Argument, das an die Select-Methode übergeben wird, ist die raw SQL-Abfrage, während das zweite Argument alle Parameterbindungen sind, die an die Abfrage gebunden werden müssen. Typischerweise sind dies die Werte der where-Klauselbeschränkungen. Die Parameteranbindung bietet Schutz vor SQL-Injektion.

Die Select-Methode gibt immer ein Array mit Ergebnissen zurück. Jedes Ergebnis innerhalb des Arrays ist ein PHP stdClass Objekt, so dass Sie auf die Werte der Ergebnisse zugreifen können:

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

Using Named Bindings

Anstatt ? zur Darstellung Ihrer Parameterbindungen zu verwenden, können Sie eine Abfrage mit benannten Bindungen ausführen:

$results = DB::select('select * from users where id = :id', ['id' => 1]);

Running An Insert Statement

Um eine insert-Anweisung auszuführen, können Sie die insert-Methode an der DB-Facade verwenden. Wie Select nimmt diese Methode die rohe SQL-Abfrage als erstes Argument und Bindings als zweites Argument:

$affected = DB::update('update users set votes = 100 where name = ?', ['John']);

Running A Delete Statement

Die delete-Methode sollte verwendet werden, um Datensätze aus der Datenbank zu löschen. Wie beim Update wird die Anzahl der betroffenen Zeilen zurückgegeben:

$deleted = DB::delete('delete from users');

Running A General Statement

Einige Datenbankanweisungen geben keinen Wert zurück. Für diese Art von Operationen können Sie die statement-Methode an der DB-Facade verwenden:

DB::statement('drop table users');

Task

Type Table

Description

<h4>Listening For Query Events</h4>

Wenn Sie jede von Ihrer Anwendung ausgef&uuml;hrte SQL-Abfrage erhalten m&ouml;chten, k&ouml;nnen Sie die Listen-Methode verwenden. Diese Methode ist n&uuml;tzlich f&uuml;r das Protokollieren von Abfragen oder das Debuggen. Sie k&ouml;nnen Ihren Query Listener bei einem <a href="http://laravel.creative-it.org/projectsall/43" title="Service Provider">Service-Provider</a> registrieren:

<pre>
<code>&lt;?php

namespace App\Providers;

use Illuminate\Support\Facades\DB;
use Illuminate\Support\ServiceProvider;

class AppServiceProvider extends ServiceProvider
{
 /**
 * Register any application services.
 *
 * @return void
 */
 public function register()
 {
 //
 }

/**
 * Bootstrap any application services.
 *
 * @return void
 */
 public function boot()
 {
 DB::listen(function ($query) {
 // $query-&gt;sql
 // $query-&gt;bindings
 // $query-&gt;time
 });
 }
}</code></pre>

Code

Task

Type Table

Description

<h4>Database Transactions</h4>

Sie k&ouml;nnen die transaction-Methode auf der DB-Facade verwenden, um eine Reihe von Operationen innerhalb einer Datenbanktransaktion auszuf&uuml;hren. Wenn innerhalb der Transaktion Closure eine Ausnahme ausgel&ouml;st wird, wird die Transaktion automatisch zur&uuml;ckgesetzt. Wenn der Closure erfolgreich ausgef&uuml;hrt wird, wird die Transaktion automatisch best&auml;tigt. Sie m&uuml;ssen sich keine Sorgen machen, dass Sie w&auml;hrend der Verwendung der transaction-Methode manuell zur&uuml;cksetzen oder festschreiben (rolling back or committing) m&uuml;ssen:

<pre>
<code>DB::transaction(function () {
 DB::table(&#39;users&#39;)-&gt;update([&#39;votes&#39; =&gt; 1]);

DB::table(&#39;posts&#39;)-&gt;delete();
});</code></pre>

<h4>Handling Deadlocks</h4>

Die transaction-Methode akzeptiert ein optionales zweites Argument, das definiert, wie oft eine Transaktion erneut versucht werden soll, wenn eine Blockierung eintritt. Sobald diese Versuche ersch&ouml;pft sind, wird eine Ausnahme ausgel&ouml;st:

DB::table(&#39;posts&#39;)-&gt;delete();
}, 5);</code></pre>

<h4>Manually Using Transactions</h4>

Wenn Sie eine Transaktion manuell starten m&ouml;chten und die volle Kontrolle &uuml;ber Rollbacks und Commits haben, k&ouml;nnen Sie die Methode beginTransaction an der DB-Facade verwenden:

<pre>
<code>DB::beginTransaction();</code></pre>

Sie k&ouml;nnen die Transaktion &uuml;ber die RollBack-Methode zur&uuml;cksetzen:

<pre>
<code>DB::rollBack();</code></pre>

Schlie&szlig;lich k&ouml;nnen Sie eine Transaktion &uuml;ber die Commit-Methode committen:

<pre>
<code>DB::commit();</code></pre>

<div style="background:#eeeeee; border:1px solid #cccccc; padding:5px 10px">Die Transaktionsmethoden der DB-Facade steuern die Transaktionen sowohl f&uuml;r den Query Builder als auch f&uuml;r Eloquent ORM.</div>

Code