options
تابع options در MySQLi برای «تنظیم گزینه ها (Options)» قبل از اتصال است. گزینه یعنی تنظیماتی که رفتار اتصال را عوض می کند؛ مثل زمان انتظار. این تابع باید بعد از init() و قبل از real_connect() صدا زده شود.
options چه می کند؟
با options() می توانی timeout، فایل پیکربندی، یا کلید عمومی سرور را تنظیم کنی. این کار روی اتصال بعدی اثر می گذارد. سپس با real_connect() وصل می شوی.
نمونه شیءگرا (Object Oriented)
<?php
$mysqli = mysqli_init();
if (!$mysqli) {
die("mysqli_init failed");
}
$mysqli->options(MYSQLI_OPT_CONNECT_TIMEOUT, 10);
$mysqli->options(MYSQLI_READ_DEFAULT_FILE, "myfile.cnf");
$mysqli->real_connect("localhost", "my_user", "my_password", "my_db");
?>
نمونه رویه ای (Procedural)
<?php
$con = mysqli_init();
if (!$con) {
die("mysqli_init failed");
}
mysqli_options($con, MYSQLI_OPT_CONNECT_TIMEOUT, 10);
mysqli_options($con, MYSQLI_READ_DEFAULT_FILE, "myfile.cnf");
mysqli_real_connect($con, "localhost", "my_user", "my_password", "my_db");
?>
گام های عملی استفاده از options
- ابتدا mysqli_init() را صدا بزن.
- گزینه ها را با options() تنظیم کن.
- با real_connect() به دیتابیس وصل شو.
گزینه های مهم
- MYSQLI_OPT_CONNECT_TIMEOUT: زمان انتظار اتصال بر ثانیه.
- MYSQLI_READ_DEFAULT_FILE: خواندن تنظیمات از فایل.
- MYSQLI_READ_DEFAULT_GROUP: خواندن تنظیمات از گروه.
- MYSQLI_SERVER_PUBLIC_KEY: مسیر کلید عمومی RSA.
نکته: این تابع را بعد از init و قبل از real_connect صدا بزن. برای ادامه مطالعه، صفحه options را نیز ببین.
هشدار: اگر بعد از اتصال، options() را صدا بزنی، اثری ندارد.
جمع بندی سریع
- options قبل از اتصال تنظیم می شود.
- با init شروع کن، سپس options.
- در پایان از real_connect استفاده کن.
- timeout و فایل تنظیمات مهم اند.