暂存

2026-05-01 23:40:14 +08:00
commit b8f599a617
3867 changed files with 478663 additions and 0 deletions
@@ -0,0 +1,170 @@
+<?php
+
+namespace Illuminate\Database;
+
+use Illuminate\Support\Facades\DB;
+use Illuminate\Support\Str;
+use PDOException;
+use Throwable;
+
+class QueryException extends PDOException
+{
+    /**
+     * The database connection name.
+     *
+     * @var string
+     */
+    public $connectionName;
+
+    /**
+     * The SQL for the query.
+     *
+     * @var string
+     */
+    protected $sql;
+
+    /**
+     * The bindings for the query.
+     *
+     * @var array
+     */
+    protected $bindings;
+
+    /**
+     * The PDO read / write type for the executed query.
+     *
+     * @var null|'read'|'write'
+     */
+    public $readWriteType;
+
+    /**
+     * The connection details for the query (host, port, database, etc.).
+     *
+     * @var array
+     */
+    protected $connectionDetails = [];
+
+    /**
+     * Create a new query exception instance.
+     *
+     * @param  string  $connectionName
+     * @param  string  $sql
+     * @param  array  $bindings
+     * @param  \Throwable  $previous
+     * @param  array  $connectionDetails
+     * @param  null|'read'|'write'  $readWriteType
+     */
+    public function __construct($connectionName, $sql, array $bindings, Throwable $previous, array $connectionDetails = [], $readWriteType = null)
+    {
+        parent::__construct('', 0, $previous);
+
+        $this->connectionName = $connectionName;
+        $this->sql = $sql;
+        $this->bindings = $bindings;
+        $this->connectionDetails = $connectionDetails;
+        $this->readWriteType = $readWriteType;
+        $this->code = $previous->getCode();
+        $this->message = $this->formatMessage($connectionName, $sql, $bindings, $previous);
+
+        if ($previous instanceof PDOException) {
+            $this->errorInfo = $previous->errorInfo;
+        }
+    }
+
+    /**
+     * Format the SQL error message.
+     *
+     * @param  string  $connectionName
+     * @param  string  $sql
+     * @param  array  $bindings
+     * @param  \Throwable  $previous
+     * @return string
+     */
+    protected function formatMessage($connectionName, $sql, $bindings, Throwable $previous)
+    {
+        $details = $this->formatConnectionDetails();
+
+        return $previous->getMessage().' (Connection: '.$connectionName.$details.', SQL: '.Str::replaceArray('?', $bindings, $sql).')';
+    }
+
+    /**
+     * Format the connection details for the error message.
+     *
+     * @return string
+     */
+    protected function formatConnectionDetails()
+    {
+        if (empty($this->connectionDetails)) {
+            return '';
+        }
+
+        $driver = $this->connectionDetails['driver'] ?? '';
+
+        $segments = [];
+
+        if ($driver !== 'sqlite') {
+            if (! empty($this->connectionDetails['unix_socket'])) {
+                $segments[] = 'Socket: '.$this->connectionDetails['unix_socket'];
+            } else {
+                $host = $this->connectionDetails['host'] ?? '';
+
+                $segments[] = 'Host: '.(is_array($host) ? implode(', ', $host) : $host);
+                $segments[] = 'Port: '.($this->connectionDetails['port'] ?? '');
+            }
+        }
+
+        $segments[] = 'Database: '.($this->connectionDetails['database'] ?? '');
+
+        return ', '.implode(', ', $segments);
+    }
+
+    /**
+     * Get the connection name for the query.
+     *
+     * @return string
+     */
+    public function getConnectionName()
+    {
+        return $this->connectionName;
+    }
+
+    /**
+     * Get the SQL for the query.
+     *
+     * @return string
+     */
+    public function getSql()
+    {
+        return $this->sql;
+    }
+
+    /**
+     * Get the raw SQL representation of the query with embedded bindings.
+     */
+    public function getRawSql(): string
+    {
+        return DB::connection($this->getConnectionName())
+            ->getQueryGrammar()
+            ->substituteBindingsIntoRawSql($this->getSql(), $this->getBindings());
+    }
+
+    /**
+     * Get the bindings for the query.
+     *
+     * @return array
+     */
+    public function getBindings()
+    {
+        return $this->bindings;
+    }
+
+    /**
+     * Get information about the connection such as host, port, database, etc.
+     *
+     * @return array
+     */
+    public function getConnectionDetails()
+    {
+        return $this->connectionDetails;
+    }
+}