آموزش ساخت autocomplete با کمک php و JQuery

خود تکمیلی (Auto-completion) یعنی برنامه یا محیط، بتونه کلمه‌ای رو که کاربر قصد تایپ اون رو داره، حدس بزنه و در صورت تایید کاربر، تکمیل کنه. به عنوان مثال: یک محل استفاده از خود تکمیلی، در فرم جستجو سایت هست که کاربر با تایپ چند کلمه، میتونه اطلاعات مطالب شما رو در یک لیست مشاهده کنه. حالا این چه مزیتی داره؟!؟ اولا سهولت در جستجو برای کاربر و ثانیا جلوگیری از خطاهای بی مورد 404.

و اما نمونه ای که ما امروز آماده کردیم، قراره که یک فیلد ورودی داشته باشه و کاربر نام کشورش رو در این فیلد وارد کنه و سپس ما با استفاده از تابع autocomplete (از کتابخانه Jquery UI) لیستی از نتایج پایگاه دادمون رو به کاربر نشون میدیم. تصویر فرآیند نهایی، به صورت زیر خواهد بود:

مراحل ساخت و پیاده سازی عبارتند از:

مرحله اول: کتابخانه

برای استفاده از این قابلیت، اول از همه می بایست 2 کتابخانه JQuery و JQuery Ui رو به همراه شیوه نامه ی jquery-ui.min.css (که ظاهر لیست dropdown رو استایل دهی میکنه) در صفحه قالبمون فراخوانی کنیم.

HTML

<link rel="stylesheet" href="http://ajax.googleapis.com/ajax/libs/jqueryui/1.10.1/themes/base/minified/jquery-ui.min.css" type="text/css" />

<script type="text/javascript" src="http://code.jquery.com/jquery-1.9.1.min.js"></script>
<script type="text/javascript" src="http://code.jquery.com/ui/1.10.1/jquery-ui.min.js"></script>

مرحله دوم: تعریف فیلد ورودی

تعریف یک فیلد ورودی که بایستی حتما یک مشخصه class یا id رو داشته باشه. این فیلد رو ما به صورت زیر تعریف کردیم که البته شما میتونید از اون در یک form هم استفاده کنید.

HTML

<input type='text' name='country' value='' class='autocom'>

مرحله سوم: فراخوانی تابع autocomplete و تعیین یک محل خوراک

در این بخش، ابتدا باید مشخه class یا id رو – که در فیلد ورودی تعیین کرده بودیم – در پیشوند فراخوانی تابع قرار بدیم. پس از انجام این کار و نوشتن تابع، نیاز به چند تنظیم ساده داریم که مربوط به تابع autocomplete میشه و مهمترینش تعیین یک محل خوراک در مشخصه source. این منبع، حتما باید از فرمت استاندارد JSON پیروی کنه و اطلاعات رو در اختیار تابع، قرار بده (برای ایجاد این منبع، محل سورس رو به فایلی با نام Search.php آدرس دهی میکنیم).

Jquery UI

<script type="text/javascript">
$(function() {
	$(".autocom").autocomplete({
		source: "search.php"
	});				
});
</script>

تا اینجای کار، کدنویسی سمت کاربر تموم شده. حالا اگه ما بیایم و مراحل بالا رو در قالب یک صفحه html جمع بندی کنیم. نتیجه اش اسکریپتی میشه که با تایپ هر رشته کلمه جدید توسط کاربر، همواره یک لینک درخواست خوارک، به محل source ارسال میکنه. این لینک حاوی نام term  و مقدار تایپ شده توسط کاربر. به عنوان مثال، اگه کاربر در فیلد ورودی رشته ی ir رو تایپ کنه، لینک درخواست فرضی ما به صورت زیر خواهد بود:

http://localhost/autocomplete/search.php?term=ir

مرحله چهارم: چاپ نتایج پایگاه داده در فرمت JSON

چهارمین مرحله که آخرین مرحله کار هم محسوب میشه، اتصال به پایگاه داده و دریافت نتایج از یک جدول نمونه است. این کار رو ما در فایل search.php – که در بالا آدرس دهی کردیم – به صورت زیر انجام میدیم:

PHP

<?php
define('DB_SERVER', 'localhost');//نام سرور
define('DB_USER', 'root');//نام کاربری دیتابیس
define('DB_PASSWORD', '');//رمز عبور دیتابیس
define('DB_NAME', ''); //نام دیتابیس

if (isset($_GET['term'])){ //شرط دریافت متد GET از URL. اگر url در خواستی به این فایل، دارای متد Get و نام term نباشد، هیچ اتفاقی نخواهد افتاد.
	$return_arr = array();
 
	try { //تلاش برای انجام فرآیندها...
	    $conn = new PDO("mysql:host=".DB_SERVER.";dbname=".DB_NAME, DB_USER, DB_PASSWORD); //ایجاد اتصال به پایگاه داده
	    $conn->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION); //تعیین ویژگی های برخورد با خطا
	    $conn->exec("set names utf8");//این خط برای پشتیبانی از رشته های utf8 که فارسی هم در این دسته قرار داره نوشته شده.
	    
	    $stmt = $conn->prepare('SELECT country FROM countries WHERE country LIKE :term'); //فراهم آوردی اطلاعات مورد نظر از ستون country و جدول countries. برای ایجاد مشابهت، حتما باید از دستور like در Sql استفاده کنیم.
	    $stmt->execute(array('term' => '%'.$_GET['term'].'%')); //این خط، فراهم آوری اطلاعات بالا رو اجرا میکنه و به متغیر :term که در قطعه کد بالا نوشته شده بود، محتوای متد GET رو مقدار دهی میکنه.
	    
	    while($row = $stmt->fetch()) { //ایجاد یک حلقه و ذخیره کردن اطلاعات هر سطر در متغیر row.
	        $return_arr[] =  $row['country']; //نتایج ستون country در آرایه return_arr ذخیره می شود.
	    }
 
	} catch(PDOException $e) { // در صورت ایجاد خطا در مرحله try، این بخش اجرا شده و متن خطا چاپ میشود.
	    echo 'ERROR: ' . $e->getMessage();
	}
 
    echo json_encode($return_arr); //چاپ نتایج آرایه return_arr به فرمت استاندارد JSON
}
?>

تمامی توضیحات در کنار کدها کامنت گذاری شدند و فک نکنم نیاز به توضیحات بیشتری داشته باشند! با اینحال تنها نکته ای که باقی مونده، دریافت اطلاعات از پایگاه داده است که ما به صورت فرضی، جدولی رو با نام countries ایجاد کردیم که دارای ستونی با نام country هست و تمامی اطلاعات از این ستون گرفته خواهد شد. شما میتونید نام این ستون و جدول فرضی رو مطابق با طراحی پایگاه دادتون تغییر بدید.