سفارش پروژه

آموزش ساخت وب سرویس در زبان PHP با NuSOAP

  • یکشنبه ۱۱ آذر ۱۳۹۷
  • بازدید ۱۱۰ نفر

web services in php using nusoap 4860 آموزش ساخت وب سرویس در زبان PHP با NuSOAP

آموزش ساخت وب سرویس در زبان PHP با NuSOAP

وب سرویس یک نرم افزار موجود بر روی اینترنت می باشد که با استفاده از پروتکل های استاندارد مانند http با سایر برنامه های کاربری به تبادل اطلاعات می پردازند. داده هایی که توسط وب سرویس ها مبادله می شوند، به صورت XML هستند. در این آموزش چگونگی ایجاد وب سرویس در PHP با استفاده از کتابخانه NuSOAP را بررسی خواهیم کرد.

در لیست زیر مراحل ایجاد یک وب سرویس SOPA با PHP را مشاهده می کنید:

  • ایجاد یک دیتابیس در MySql و یک جدول برای کتاب ها
  • درج اطلاعاتی در داخل این جدول
  • ایجاد یک فرم HTML برای گرفتن شماره ISBN (شابک کتاب) از کاربر
  • ارسال اطلاعات فرم به یک صفحه PHP و وب سرویس
  • ایجاد یک وب سرویس متصل به دیتابیس MySql
  • گرفتن اطلاعات کتاب بر اساس شماره ISBN دریافت شده و ارسال آن ها به کلاینت
  • نمایش اطلاعات دریافت شده به کاربر

وب سرویس SOAP چیست

SOAP یا Simple Object Access Protocol یک پروتکل ارتباطی برای تبادل پیام بین کامپیوترها است. برای کار با SOAP باید یک درک کلی از عناصر SOAP داشته باشید.

بسته SOAP

پروتکل SOAP یک فرمت استاندارد به منظور ارسال و دریافت پیام دارد. این استاندارد توسط W3C تعریف شده است. هر پیام SOAP به صورت یک سند XML می باشد که یک عنصر ریشه به نام SOAP Envelope دارد. یک بسته SOAP شامل دو بخش هدر (Header) و بدنه (Body) می باشد که بخش هدر آن اختیاری و بخش بدنه اجباری است. در داخل بدنه پارامترهای مختلفی وجود دارد که شامل اطلاعاتی است که ارسال و یا دریافت می شوند. SOAP یک قرار داد بین کلاینت و سرور است.

web services in php using nusoap 4860 1 آموزش ساخت وب سرویس در زبان PHP با NuSOAP

WSDL (Web Service Description Language)

WSDL استاندارد W3C می باشد که به عنوان یک قرار داد بین سرور و کلاینت عمل می کند. WSDL محل، عملیات و پارامترهای وب سرویس را شامل می شود. متدهای در دسترس توسط تگ های operation مشخص می شوند. همچنین از تگ message برای تعریف پارامترهای ورودی خروجی سرویس استفاده می شوند. وب سرویس ها را می توان با هر یک از زبان های برنامه نویسی پیاده سازی کرد. همه زبان ها ابزارهایی را برای پیاده سازی وب سرویس ها دارد. NuSOAP یک ابزار محبوب در زبان PHP می باشد که به منظور ایجاد وب سرویس ها استفاده می شود. در این آموزش چگونگی استفاده از کتابخانه NuSOAP را بررسی خواهیم کرد.

آموزش نحوه ساخت وب سرویس در PHP با NuSOAP

جهت ایجاد و استفاده از وب سرویس در زبان php مراحل زیر را به دقت انجام دهید.

ایجاد دیتابیس MySql

قبل از هر کاری یک دیتابیس و یک جدول برای وب سرویس مورد نظرمان ایجاد می کنیم. برای اینکار وارد phpMyAdmin شوید و دستورات SQL زیر را اجرا کنید.

web services in php using nusoap 4860 2 آموزش ساخت وب سرویس در زبان PHP با NuSOAP

web services in php using nusoap 4860 3 آموزش ساخت وب سرویس در زبان PHP با NuSOAP

ایجاد پوشه php-webservices

دایرکتوری ریشه سایت خود را باز کنید و یک پوشه با نام  php-webservices ایجاد کنید. سپس کتابخانه NuSOAP را که در انتهای این بخش قرار داده شده است دانلود کرده و پوشه lib موجود را در پوشه php-webservices کپی کنید.

محتوای فایل اتصال به دیتابیس با استفاده از PDO

یک فایل با نام dbconn.php ایجاد کرده و کد زیر را در آن قرار دهید:

ایجاد وب سرویس Books با استفاده از NuSOAP

یک فایل با نام webservice-server.php ایجاد کنید. سپس فایل های dbconn.php و nusoap.php را در آن include کنید. برای ایجاد یک وب سرویس، باید از متد nusoap_server() استفاده کنید که یک شیء soap server باز می گرداند.

تابع  fetchBookData($isbn){ … }که در بالا تعریف شده است، به عنوان یک وب سرویس عمل می کند. برای استفاده از شیء اتصال پایگاه داده از dbconn.php، $dbconn به عنوان یک شیء عمومی اعلام شده است. یک پرس و جو برای استخراج یک رکورد کتاب با $isbn به عنوان پارامتر نامیده شده تعریف شده است.

برای کار با دیتابیس باید از شیء $dbconn که در فایل dbconn.php ایجاد شده است، استفاده می شود. کوئری تعریف شده اطلاعات کتاب را بر اساس ISBN دریافت شده انتخاب می کند. دستور Prepare برای آماده سازی دیتابیس استفاده می شود. متد bindParam پارامتر $isbn را به کوئری اضافه می کند. متد execute کوئری را اجرا می کند و نتیجه کوئری توسط متد fatch() استخراج شده و در متغیر $data قرار می گیرد. داده های دریافت شده با استفاده از json_encode رمزگذاری می شود و به کلاینت ارسال می شود.

پیکربندی WSDL برای وب سرویس

به منظور پیکربندی WSDL از متد configureWSDL استفاده می شود. حالت کلی استفاده از این متد به صورت زیر می باشد و اکثرا به این صورت مورد استفاده قرار می گیرد. با این حال ممکن است در سایر مستندات حالت متفاوتی از این متد را مشاهده کنید.

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

کد بالا، تابع fetchBookData را به عنوان یک وب سرویس ثبت می کند. اطلاعات دیگر پارامترهای ورودی و خروجی را تعیین می کنند که در کد بالا یک رشته به عنوان ورودی و یک رشته به عنوان خروجی مشخص شده است.

xsd به عنوان شِمای XML مورد استفاده قرار می گیرد. با استفاده از xsd می توانید به انواع داده های پایه مانند integer، float، string و غیره دسترسی داشته باشید.

نمایش سند WSDL

مرورگر وب خود را باز کرده و URL زیر را در قسمت آدرس بار مرورگر تایپ کنید.

web services in php using nusoap 4860 4 آموزش ساخت وب سرویس در زبان PHP با NuSOAP

هنگامی که به آدرس بالا بروید یک صفحه مانند شکل بالا را مشاهده خواهید کرد. اگر بر روی کلمه WSDL که به صورت لینک می باشد کلیک کنید یک WSDL نمایش داده خواهد.

web services in php using nusoap 4860 5 آموزش ساخت وب سرویس در زبان PHP با NuSOAP

در پایین این سند و در داخل تگ service، نام وب سرویس ذکر شده است. تگ soap:address آدرس وب سرویس را نشان می دهد. نگ operation شامل نام تابع fetchBookData است که برای دریافت داده های کتاب استفاده می شود. تگ message با نام fetchBookDataRequest مشخص می کند که وب سرویس یک پارامتر ISBN لازم دارد که باید از نوع رشته باشد. همچنین تگ fetchBookDataResponse مشخص می کند که وب سرویس یک رشته را به عنوان خروجی باز می گرداند.

وب سرویس سمت کلاینت را می توان با استفاده از هر زبانی پیاده سازی کرد. کلاینت باید پیام مورد نظر را در یک فرمت خاص که توسط WSDL تعریف شده است ارسال کند.

ایجاد فرم HTML برای دریافت شماره ISBN کتاب

بعد از راه اندازی سرور، حال باید بر روی برنامه سمت کلاینت کار کنیم. به منظور ایجاد فرم دریافت شماره شابک کتاب، یک فایل با نام webservice_client.php ایجاد کرده و کد زیر را در داخل آن قرار دهید.

کد بالا، مانند شکل زیر یک TextBox به همراه یک Button در صفحه ایجاد می کند. هنگامی کاربر شماره ISBN را وارد کند و بر روی دکمه کلیک کند، اطلاعات به سرور ارسال خواهند شد.

web services in php using nusoap 4860 6 آموزش ساخت وب سرویس در زبان PHP با NuSOAP

در کد بالا، فایل nusoap.php موحود در پوشه lib را به برنامه اضافه می شود و آدرس WSDL را در متغیر $wsdl ذخیره می شود. سپس درست بودن اطلاعات دریافتی از کلاینت بررسی می شود.

کد زیر برای ایجاد یک شیء از نوع nusoap_client استفاده می شود:

پارامتر اول، آدرس WSDL را مشخص می کند و پارامتر دوم که true می باشد، به متد می گوید که پارامتر اول یک WSDL است. از متد call موجود در شیء client برای فراخوانی وب سرویس استفاده می کنیم.

این متد دو پارامتر می گیرد که اولی نام تابع وب سرویس و دومی آرایه ای است که شامل پارامترهای لازم مانند شماره ISBN می باشد. پاسخ دریافتی از وب سرویس توسط تابع json_decode رمزگشایی شده و در متغیر $result قرار می گیرد.

نمایش نتیجه به کاربر

بعد از فرم دریافت شماره ISBN، با استفاده از کد زیر یک جدول به منظور نمایش پاسخ دریافتی از وب سرویس ایجاد کنید.

کد بالا یک جدول با ستون های عنوان، نویسنده، قیمت و شماره شابک ایجاد خواهد کرد.

اجرای برنامه

برای آن که برنامه بالا در سیستم شما اجرا شود، مطمئن شوید که مراحل زیر را انجام داده اید.

  • ایجاد یک دیتابیس با نام dbbookstore.
  • تغییر اطلاعات امنیتی مورد نیاز در فایل php متناسب با آن چه در MySql خود تنظیم کرده اید.
  • تغییر آدرس $wsdl موجود در فایل webservice-client.php متناسب با آدرس هاست خود.

باکس دانلود
شناسه:
۴۸۶۰
فرمت فایل:
rar
اندازه فایل:
۱۴۰ کیلوبایت
لینک دانلود:
روی دکمه G+1 برای محبوب کردن سایت کلیک کرده سپس از لینک زیر دانلود را انجام دهید
مطالب مرتبط
ثبت نظر
ریفریش کنید!
نظرات کاربران (۰ مورد)

هیچ نظری ثبت نشده است