PDO::setAttribute — تعيين السمات (PHP 5 >= 5.1.0، PECL pdo >= 0.1.0)
منطقي PDO::setAttribute (سمة int $، قيمة $مختلطة)
تعيين خصائص مقبض قاعدة البيانات. بعض الخصائص الشائعة المتوفرة مذكورة أدناه؛ وقد تستخدم بعض برامج التشغيل خصائص محددة إضافية.
PDO::ATTR_CASE : فرض أسماء الأعمدة على الحالة المحددة.
PDO::CASE_LOWER : فرض كتابة أسماء الأعمدة بأحرف صغيرة.
PDO::CASE_NATURAL : احتفظ بأسماء الأعمدة التي تم إرجاعها بواسطة برنامج تشغيل قاعدة البيانات.
PDO::CASE_UPPER : فرض أن تكون أسماء الأعمدة بأحرف كبيرة.
PDO::ATTR_ERRMODE : الإبلاغ عن الأخطاء.
PDO::ERRMODE_SILENT : يضبط رمز الخطأ فقط.
PDO::ERRMODE_WARNING : يظهر خطأ E_WARNING
PDO::ERRMODE_EXCEPTION : يطرح استثناءات .
PDO::ATTR_ORACLE_NULLS (متوفر في كافة برامج التشغيل، وليس مقتصرًا على Oracle): تحويل السلاسل الفارغة والفارغة.
PDO::NULL_NATURAL : لا يوجد تحويل.
PDO::NULL_EMPTY_STRING : تحويل السلسلة الفارغة إلى NULL
.
PDO::NULL_TO_STRING : تحويل NULL إلى سلسلة فارغة.
PDO::ATTR_STRINGIFY_FETCHES : تحويل القيم إلى سلاسل عند الاستخراج. يتطلب منطقيا .
PDO::ATTR_STATEMENT_CLASS : يضبط فئة البيان المقدمة من المستخدم والمشتقة من PDOStatement. لا يمكن استخدامه مع مثيلات PDO المستمرة. يتطلب صفيفًا (اسم فئة السلسلة، صفيفًا (معلمات مُنشئ مختلطة)) .
PDO::ATTR_TIMEOUT : يحدد عدد الثواني للمهلة. لا تدعم جميع برامج التشغيل هذا الخيار، مما يعني أنه قد تكون هناك اختلافات من سائق لآخر. على سبيل المثال، ينتظر SQLite هذه القيمة قبل التخلي عن الحصول على قفل قابل للكتابة، ولكن قد تفسر برامج التشغيل الأخرى هذه القيمة على أنها اتصال أو فاصل زمني لمهلة القراءة. يتطلب نوع int.
PDO::ATTR_AUTOCOMMIT (متوفر في OCI وFirebird وMySQL): ما إذا كان سيتم تنفيذ كل عبارة على حدة تلقائيًا.
يعمل PDO::ATTR_EMULATE_PREPARES على تمكين أو تعطيل محاكاة البيانات المعدة. بعض برامج التشغيل ليس لديها دعم أو دعم محدود للمعالجة المسبقة المحلية. استخدم هذا الإعداد لإجبار PDO على محاكاة البيانات المعدة دائمًا (إذا كانت TRUE
)، أو حاول استخدام البيانات المعدة محليًا (إذا كانت FALSE
). إذا لم يتمكن برنامج التشغيل من إعداد الاستعلام الحالي بنجاح، فسيعود دائمًا إلى محاكاة البيانات المعدة. يتطلب نوع منطقي .
PDO::MYSQL_ATTR_USE_BUFFERED_QUERY (متوفر في MySQL): استخدم الاستعلامات المخزنة مؤقتًا.
PDO::ATTR_DEFAULT_FETCH_MODE : اضبط وضع الجلب الافتراضي. يمكن العثور على وصف للوضع في وثائق PDOStatement::fetch() .
إرجاع TRUE عند النجاح، أو FALSE عند الفشل.