PHP mysql_pconnect() فونکشن

تعریف اور استعمال

mysql_pconnect() فونکشن سے MySQL سرور کی پرسٹنٹ وابستگی کھولی جاتی ہے۔

mysql_pconnect() اور mysql_connect() بہت ساتھ مشابه ہیں، لیکن دو اہم فرق ہیں:

  1. وابستگی کی وجہ سے اس فونکشن سے پہلے ایک ایسا (پرسٹنٹ) وابستگی تلاش کی جائے گی جو ایک ہی میزبان پر اسی نام کا استعمال اور پاروسی کا استعمال کر رہا ہو، اگر پائی جائے تو اس وابستگی کا شناختی نمبر واپس دینا جائے گا اور نئی وابستگی کھولنا نہیں ہوگا۔
  2. جب اسکریپت کا نفاذ مکمل ہوجائے گا تو اس سے SQL سرور کی وابستگی بند نہیں ہوگی، یہ وابستگی کھلے رہے گی تاکہ بعد میں استعمال کیا جاسکے (mysql_close() mysql_pconnect() سے قائم کردہ وابستگی کو بند نہیں کردا ہے)۔

فارمائش

mysql_pconnect(سرور,user,pwd,clientflag)
پارامتر وصف
سرور

اختیاری۔ وابستگی کا سرور مقرر کرتا ہے۔

شامل ہوسکتا ہے پورٹ نمبر، مثلاً "hostname:port"، یا لوکل سککٹ کی راستے کے لئے، مثلاً لوکال ہوسٹ کے لئے ":/path/to/socket"۔

اگر دستور php mysql.default_host تعریف نشده باشد (مورد پیش‌فرض)، مقدار پیش‌فرض 'localhost:3306' است.

user اختیاری. نام کاربری. مقدار پیش‌فرض نام کاربری صاحب فرآیند سرور است.
pwd اختیاری. رمز عبور. مقدار پیش‌فرض یک رمز عبور خالی است.
clientflag

اختیاری.clientflags پارامتر می‌تواند ترکیبی از یکی از مقادیر زیر باشد:

  • MYSQL_CLIENT_SSL - از رمزنگاری SSL استفاده می‌کند
  • MYSQL_CLIENT_COMPRESS - از پروتکل فشرده‌سازی استفاده می‌کند
  • MYSQL_CLIENT_IGNORE_SPACE - اجازه می‌دهد که فاصله‌ای پس از نام فنکشن وجود داشته باشد
  • MYSQL_CLIENT_INTERACTIVE - اجازه می‌دهد که زمان غیرفعال تعامل پیش از بستن اتصال بسته شود

مقدار بازگشتی

اگر موفق شد، شناسه اتصال پایدار MySQL را برمی‌گرداند، در غیر این صورت FALSE برمی‌گرداند.

توجه و نظرات

توضیح:پارامتر اختیاری clientflag از نسخه PHP 4.3.0 به بعد قابل استفاده است.

توجه:برای ایجاد یک اتصال غیرمستمر، از mysql_connect() فنکشن.

مثال

<?php
$con = mysql_pconnect("localhost","mysql_user","mysql_pwd");
if (!$con)
  {
  die('نمی‌توان متصل شد: ' . mysql_error());
  }
?>