توابع mysql_pconnect() در PHP

تعریف و نحوه استفاده

توابع mysql_pconnect() یک اتصال پایدار به سرور MySQL باز می‌کند.

mysql_pconnect() و mysql_connect() بسیار مشابه هستند، اما دو تفاوت اصلی دارند:

  1. هنگام اتصال، این تابع ابتدا تلاش می‌کند تا یک اتصال (پایدار) باز شده با نام کاربری و رمز عبور مشابه در همان سرور پیدا کند، اگر پیدا کند، شناسه این اتصال را بازمی‌گرداند و اتصال جدیدی باز نمی‌کند.
  2. در مرحله بعد، هنگامی که اسکریپت اجرا شد، اتصال به سرور SQL بسته نمی‌شود، این اتصال باز باقی می‌ماند تا در آینده استفاده شود (mysql_close() اتصال ایجاد شده توسط mysql_pconnect() را بسته نمی‌کند).

نحوه استفاده

mysql_pconnect(سرور,user,pwd,clientflag)
پارامتر توضیح
سرور

اختیاری. سروری که می‌خواهید متصل شوید را مشخص می‌کند.

میتواند شامل پورت اتصال باشد، به عنوان مثال "hostname:port"، یا مسیر به سوکت محلی، به عنوان مثال برای localhost ":/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());
  }
?>