MySQL Functions

mysql_create_db

Mohammad Ali — Thu, 28 Dec 2006 11:53:30 +0000

mysql_create_db

(PHP 3, PHP 4, PHP 5)

به وسیله این تابع میتوانید پایگاه های داده (Database) مای اسکیوال ایجاد نمائید .

bool mysql_create_db ( string database_name [, resource link_identifier] )

توضیح :

تابع mysql_create_db() این امکان را به شما میدهد که برروی سرور به کمک یک اتصال دهنده پایگاه داده پایگاه داده (Database) جدید ایجاد نمائید .

مقادیر :

database_name

نام پایگاه داده ای که قرار است ایجاد شود .

link_identifier

ارتباط دهنده پایگاه داده (Link_identifier) ، اگر ارتباط دهنده پایگاه داده تعیین نشده باشد آخرین ارتباط برقرار شده به توسط ()Mysql_connet به طور پیشفرض به عنوان مقدار قرار میگرد ، در صورتی که ارتباط دهنده ای پیدا نشود تابع سعی میکند که یک ارتباط دهنده ایجاد نماید که این ارتباط دهنده بی مقدار میباشد ، در صورتی که تابع نتواند ارتباط دهنده ای پیدا یا ایجاد نماید پیغام خطایی نمایش داده میشود

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

تابع در صورت موفق بودن مقدار True و در غیر این صورت مقدار False را بر میگرداند .

مثال ها :

مثال 1 : مثالی از تابع . mysql_create_db()

$link = mysql_connect(‘localhost’, ‘mysql_user’, ‘mysql_password’);
if (!$link) {
die(‘Could not connect: ‘ . mysql_error());
}

$sql = ‘CREATE DATABASE my_db’;
if (mysql_query($sql, $link)) {
echo “Database my_db created successfully\n”;
} else {
echo ‘Error creating database: ‘ . mysql_error() . “\n”;
}
?>

خروجی مثال بالا چیزی شبیه خروجی زیر میباشد :

Database my_db created successfully

نکات :

نکته : میتوانید به جای استفاده از mysql_create_db() از mysql_createdb() نیز استفاده نمائید .

mysql_connect

Mohammad Ali — Thu, 28 Dec 2006 09:30:17 +0000

mysql_connect

(PHP 3, PHP 4, PHP 5)

برقراری ارتباط با MySQL Server

resource mysql_connect ( [string server [, string username [, string password [, bool new_link [, int client_flags]]]]] )

توضیح :

برقرار کردن یا استفاده مجدد ارتباط با MySQL Server

پارامترها :

Server

سرور مای اسکیوال ، مقدار این آرگومان میتواند شامل پورت مانند : “hostname:port” یا در یک مسیر داخلی مانند ““:/path/to/socket برای Localhost باشد . اگر در تنظیمات PHP mysql.default_host تعریف نشده باشد (پیشفرض) در این زمان مقدار پیشفرض ‘localhost:3306′ قرار میگرد . در SQL safe mode این پارامتر ایگنور میشود و مقدار ‘localhost:3306′ بطور معمول مورد استفاده قرار میگرد

Username

نام کاربری ، مقدار پیشفرض این پارامتر از طریقmysql.default_user مشخص میشود. در SQL safe mode این پارامتر ایگنور میشود و کاربری که میتواند به پردازش سرور دسترسی داشته باشد به کار برده میشود

Password

کلمه عبور ، مقدار پیشفرض این پارامتر از طریق mysql.default_password مشخص میشود . در SQL safe mode ، این پارامتر نادیده گرفته میشود و کلمه عبور خالی مورد استفاده قرار میگرد .

new_link

If a second call is made to mysql_connect() with the same arguments, no new link will be established, but instead, the link identifier of the already opened link will be returned. The new_link parameter modifies this behavior and makes mysql_connect() always open a new link, even if mysql_connect() was called before with the same parameters. In SQL safe mode, this parameter is ignored.

client_flags

The client_flags parameter can be a combination of the following constants: MYSQL_CLIENT_SSL, MYSQL_CLIENT_COMPRESS, MYSQL_CLIENT_IGNORE_SPACE or MYSQL_CLIENT_INTERACTIVE. Read the section about Table 2 for further information. In SQL safe mode, this parameter is ignored.

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

این تابع در صورت موفق بودن در اجرا ارتباط دهنده پایگاه داده (Link_identifier) و در صورت ناموفق بودن مقدار False را برمیگرداند .

تاریخچه تغییرات :

نسخه	توضیحات
4.3.0	Added the client_flags parameter.
4.2.0	Added the new_link parameter.
3.0.10	Added support for “:/path/to/socket” with server.
3.0.0	Added support for “:port” with server.

مثال ها :

مثال 1 : مثالی از mysql_connect()

$link = mysql_connect(‘localhost’, ‘mysql_user’, ‘mysql_password’);
if (!$link) {
die(‘Could not connect: ‘ . mysql_error());
}
echo ‘Connected successfully’;
mysql_close($link);
?>

مثال 2 : مثالی از mysql_connect() با بکارگیری قوانین hostname:port

// we connect to example.com and port 3307
$link = mysql_connect(‘example.com:3307′, ‘mysql_user’, ‘mysql_password’);
if (!$link) {
die(‘Could not connect: ‘ . mysql_error());
}
echo ‘Connected successfully’;
mysql_close($link);

// we connect to localhost at port 3307
$link = mysql_connect(’127.0.0.1:3307′, ‘mysql_user’, ‘mysql_password’);
if (!$link) {
die(‘Could not connect: ‘ . mysql_error());
}
echo ‘Connected successfully’;
mysql_close($link);
?>

مثال 3 : مثالی از mysql_connect() با بکارگیری قوانین “:/path/to/socket”

// we connect to localhost and socket e.g. /tmp/mysql.sock

//variant 1: ommit localhost
$link = mysql_connect(‘/tmp/mysql’, ‘mysql_user’, ‘mysql_password’);
if (!$link) {
die(‘Could not connect: ‘ . mysql_error());
}
echo ‘Connected successfully’;
mysql_close($link);

// variant 2: with localhost
$link = mysql_connect(‘localhost:/tmp/mysql.sock’, ‘mysql_user’, ‘mysql_password’);
if (!$link) {
die(‘Could not connect: ‘ . mysql_error());
}
echo ‘Connected successfully’;
mysql_close($link);
?>

نکات :

نکته : ارتباطی که با سرور مای اسکیوال برقرار شدن به محض پابان یافتن اجرای دستورات اسکریپت بسته میشود ، ولی اگر بخواهید زودتر و به وضوح این کار صورت بگیرد باید از تابع mysql_close()استفاده نمائید

نکته : شما میتوانید جلوی نمایش پیغام خطا را به وسبله اضافه کردن یک @ بر اول تابع بگیرید .

mysql_close

Mohammad Ali — Mon, 25 Dec 2006 14:45:22 +0000

mysql_close

(PHP 3, PHP 4, PHP 5)

پایان دادن (بستن) به اتصال سرور پایگاه داده .

bool mysql_close ( [resource link_identifier] )

توضیح :

این تابع میتواد به اتصالات غیر ماندگاری که با سرور MySQL برقرار شده است پایان دهد این تابع یک مقدار یا آرگومان دارد که ارتباط دهند پایگاه داده (link_identifier) نامیده میشود در صورتی که این مقدار مشخص نشود آخرین اتصال صورت گرفته به عنوان مقدار این تابع قرار میگرد .

استفاده از تابع mysql_close() همیشه ضروری نیست چون که اتصالات غیر ماندگار خود به خود بسته میشوند .

پارامترها :

link_identifier

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

تابع در صورت موفق بودن مقدار True و در غیر این صورت مقدار False را بر میگرداند .

مثال ها :

مثال 1 : مثالی از ()mysql_close

$link = mysql_connect(‘localhost’, ‘mysql_user’, ‘mysql_password’);
if (!$link) {
die(‘Could not connect: ‘ . mysql_error());
}
echo ‘Connected successfully’;
mysql_close($link);
?>

خروجی مثال بالا چیزی شبیه خروجی زیر میباشد :

Connected successfully

نکات :

تابع mysql_close() نمیتواند به اتصالات ماندگاری که توسط تابع mysql_pconnect() ایجاد میشود پایان دهد .

mysql_client_encoding

Mohammad Ali — Sun, 24 Dec 2006 19:23:42 +0000

mysql_client_encoding

(PHP 4 >= 4.3.0, PHP 5)

با این تابع میتوانید نوع کاراکتر (Encoding) ست شده دیتایس را تشخیص دهید .

string mysql_client_encoding ( [resource link_identifier] )

توضیح :

به وسیله این تابع میتوانید نوع کاراکتر (Encoding) ست شده بر روی یک دیتابیس خاص را بدست آورید .

پارامترها :

link_identifier

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

نام کاراکتر (Encoding) ست شده را بر میگرداند

مثال ها :

مثال 1 : مثالی از ()mysql_client_encoding

$link = mysql_connect(‘localhost’, ‘mysql_user’, ‘mysql_password’);
$charset = mysql_client_encoding($link);

echo “The current character set is: $charset\n”;
?>

خروجی مثال بالا چیزی شبیه خروجی زیر میباشد : :

The current character set is: latin1

mysql_change_user

Mohammad Ali — Sat, 23 Dec 2006 10:55:36 +0000

mysql_change_user

(PHP 3 >= 3.0.13)

تعویض نام کاربری لوگین شده در اتصال فعال به دیتابیس با یک کاربر دیگر.

int mysql_change_user ( string user, string password [, string database [, resource link_identifier]] )

توضیح :

به وسیله این تابع میتوانید کاربر لوگین شده در یک اتصال فعال به دیتابیس را تعویض کنید ، اگر اتصال دهنده بانک اطلاعاتی (Link_identifier) مشخص نشده باشد آخرین اتصال فعال به عنوان

مقدار این پارامتر قرار میگرد همچنین اگر دیتابیسی به عنوان مقدار پارامتر String Database انتخاب شده باشد دیتابیس جدید ، در اتصال جدید به عنوان دیتابس قرار میگرد. در صورتی که عملیات

تعویض کاربر با موفقیت انجام نشود اتصال قبلی مجددا” به عنوان اتصال فعال قرار میگرد .

این تابع به علت ناراضی بودن از آن بعد از مدتی از PHP حذف گردید.

پارامترها :

user

نام کاربری بانک اطلاعاتی جدید

password

کلمه عبور بانک اطلاعاتی جدید

database

نام بانک اطلاعاتی ، در صورتی که این پارامتر مقدار دهی نشود دیتابیس قبلی به عنوان مقدار این پارامتر قرار میگرد

link_identifier

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

تابع در صورت موفق بودن مقدار True و در غیر این صورت مقدار False را بر میگرداند .

گزارش تغییرات :

نسخه	توضیحات
3.0.14	این تابع از پی اچ پی حذف گردید

نکات :

نیازمندی ها : این تابع برای اجرا نیاز به نسخه های بالاتر از 3.23.3 MySQL دارد

mysql_ affected _rows

Mohammad Ali — Fri, 22 Dec 2006 17:34:00 +0000

mysql_ affected _rows

(PHP 3, PHP 4, PHP 5)

بدست آوردن تعداد سطرهایی (rows) تحت تاثیر (Affected) قرار گرفته در عملیات (Query) قبلی مای اسکیو ال.

Int mysql_affected_ rows ( [resource link_identifier] )

توضیح :

به توسط این تابع میتوانید تعداد، رکوردهایی که در عملیات قبلی مای اسکیو ال ایجاد ، بروز ، تغییر یا حذف شده اند را بدست بیاورید .

پارامترها :

Link _ identifier

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

تابع در صورت موفق بودن در اجرا تعداد ، سطرهایی که تحت تاثیر (Affected) قرار گرفته اند را بر میگرداند . در صورتی که آخرین عملیات ناموفق بوده باشد مقدار 1- را برخواهد گرداند .

در صورتی که آخرین عملیات ، دستور حذف سطرها بدون شرط WHERE بوده باشد تمامی رکوردها از جدول حذف خواهند شد اما این تابع در ورژن های قبل از 4.1.2 مای اسکیو ال مقدار 0 را برمیگرداند

هنگام جایگزینی (Replace) ابتدا رکوردهای مورد نظر حذف سپس رکوردهای جدید در جدول قرار میگرند ، این تابع تعداد رکوردهای حذف شده بعلاوه تعداد رکوردهای قرار گرفته را برمیگرداند.

مثال ها :

مثال 1 : مثالی از ()mysql_affected_rows

$link = mysql_connect(‘localhost’, ‘mysql_user’, ‘mysql_password’);
if (!$link) {
die(‘Could not connect: ‘ . mysql_error());
}
mysql_select_db(‘mydb’);

/* this should return the correct numbers of deleted records */
mysql_query(‘DELETE FROM mytable WHERE id < 10′);
printf(“Records deleted: %d\n”, mysql_affected_rows());

/* with a where clause that is never true, it should return 0 */
mysql_query(‘DELETE FROM mytable WHERE 0′);
printf(“Records deleted: %d\n”, mysql_affected_rows());
?>

خروجی مثال بالا چیزی شبیه خروجی زیر میباشد : :

Records deleted: 10

Records deleted: 0

مثال 2 : مثال دیگری از ()mysql_affected_rows

$link = mysql_connect(‘localhost’, ‘mysql_user’, ‘mysql_password’);
if (!$link) {
die(‘Could not connect: ‘ . mysql_error());
}
mysql_select_db(‘mydb’);

/* Update records */
mysql_query(“UPDATE mytable SET used=1 WHERE id < 10″);
printf (“Updated records: %d\n”, mysql_affected_rows());
mysql_query(“COMMIT”);
?>

خروجی مثال بالا چیزی شبیه خروجی زیر میباشد : :

Updated Records: 10

نکات :

Transactions: If you are using transactions, you need to call mysql_affected_rows() after your INSERT, UPDATE, or DELETE query, not after the COMMIT.

SELECT Statements: To retrieve the number of rows returned by a SELECT, it is possible to use mysql_num_rows().