تصميم موقع الويب الخاص بك مع PHP و MySQL


الدرس: استخدام وثائق PHP!


الصفحة السابقة
واحدة من المزايا الكبيرة في PHP هي وثائقها الكاملة و المجانية ، المتوفرة على الإنترنت ، وترجمتها إلى العديد من اللغات .
ومع ذلك ، عندما يخبرنا شخص ما "  حل مشكلتك في المستند  " ، فإننا نميل إلى الارتعاش قليلاً. نحن نعتقد أن المستند "عبارة عن كتلة غير منظمة وغير مقروءة ، ولدينا فيها كل فرصة لتضيع.
هذا خطأ. كما قلت لك ، وثائق PHP كاملة ومُنظمة بشكل جيد ،. كل شيء هناك.
الغرض من هذا الملحق هو إظهار كيفية عمل المستند ، بحيث يمكنك بعد ذلك العثور على المعلومات التي تبحث عنها بنفسك ، دون مساعدة مني. 

الوصول إلى المستند


التوثيق جيد ، لكن أين هو؟ كيف نصل إلى هناك؟
هناك احتمالان لذلك ، كل هذا يتوقف على ما تريد القيام به.
  • راجع قائمة الوظائف المصنفة حسب السمات  : إذا كنت لا تعرف بالضبط الوظيفة التي تبحث عنها ، إذا كنت تريد التجول قليلاً والحصول على قائمة الوظائف المصنفة حسب الفئات ... هذه هي الطريقة الأولى التي ستستخدمها.
  • قم بالوصول إلى عرض تقديمي لوظيفة معروفة باسمها  : إذا كنت تعرف اسم دالة ، لكنك لا تعرف كيفية استخدامها ، فهذه هي الطريقة الثانية التي سنستخدمها. إنها الطريقة الأبسط والأسرع والأكثر استخدامًا.
سأقوم الآن بالتفصيل لكل من الطريقتين للوصول إلى المستند. سوف تستخدم واحدة أو أخرى وفقا لاحتياجاتك.
قائمة الوظائف المصنفة حسب المواضيع
يجب وضع إشارة مرجعية على هذا العنوان حتى لا تنساه أبدًا:
هذا هو ملخص وظائف PHP ، باللغة الانجليزية.
إذا ذهبت إلى الصفحة ، يجب أن ترى شيئًا يشبه الشكل التالي.
web dynamique php
قائمة الوظائف المصنفة حسب المواضيع
ما تراه هناك قائمة "السمات" من الوظائف. كما ترون ، هناك مجموعة كاملة!

لا تخف إذا كنت لا تفهم حتى سمة في عشرة ، ولكن ابذل جهدًا لقراءة كل شيء هناك ، وحدد ما إذا كان هناك موضوع يثير اهتمامك أكثر من الآخر .
على سبيل المثال ، يمكنك رؤية المواضيع "Mail" و Mathematical"" . لنفترض أنني مهتم بالوظائف الرياضية لـ PHP . أنا اضغط على "الرياضيات"  .

هناك ، يتم فتح صفحة جديدة. نحن نقدم لك مقدمة قصيرة أوصي بأن تقرأها في كل مرة ، وكذلك قائمة الوظائف.
لا يتم تنشيط بعض سمات الوظائف باستخدام PHP . هذه هي الحالة ، على سبيل المثال ، مكتبة GD لإنشاء الصور.

إذا كان الأمر كذلك ، يُطلب منك "تنشيط" المكتبة ، كما علمتك أن تفعل ذلك في الفصل الخاص بـ GD .
تنتمي الوظائف الأخرى إلى الملحقات التي يجب تثبيتها يدويًا.

بالنسبة للوظائف الرياضية ، يتم تنشيطها دائمًا افتراضيًا ، لذلك لا توجد مشكلة هناك.
انتقل إلى أسفل الصفحة (في بعض الأحيان يجب أن تكون منخفضًا جدًا) ، إلى المكان الذي يتم فيه كتابة "جدول المحتويات". هذا هو المكان الذي نحن مهتمون به: هناك قائمة من وظائف موضوع "الرياضيات" ، كما هو مبين في الشكل التالي.
web dynamique php
بعض الوظائف الرياضية
على اليسار ، لديك اسم الوظيفة ، وعلى اليمين وصف موجز للغاية لما تقوم به.
إذا قمت بالنقر فوق اسم الوظيفة ، يمكنك الوصول إلى عرض الوظيفة. سنرى كيف تعمل هذه الصفحة في الجزء الثاني من هذا الملحق.
هنا على سبيل المثال ، قد أكون مهتمًا بحساب لوغاريتم طبيعي (دالة log ) . حتى لو كانت الرياضيات وأنت غير متّفقان ، فما زالت هناك بعض الوظائف التي يجب أن تهمك : max والتي تُرجع أكبر عدد ، أو mt_rand التي تنشئ رقمًا عشوائيًا.
الوصول المباشر إلى وظيفة
من الشائع أن تعرف اسم الوظيفة ، لكنك لا تعرف كيفية استخدامها.
هناك ، لم تعد مسألة "التنزه" بين سمات الوظائف لتحديد موقع مثير للاهتمام: نود أن نحصل مباشرة على وصف الوظيفة.
على سبيل المثال ، افترض أنك تريد إنشاء رقم عشوائي بين 0 و 100. أنت تعرف أن الوظيفة تسمى  mt_rand لأن شخصًا ما تحدث عنها في أحد المنتديات.
عادةً ما تكون هذه المعلومات كافية: لديك اسم الوظيفة وعليك فقط توثيق نفسك.
للوصول إلى عرض تقديمي لوظيفة ما مباشرةً ، اكتب العنوان التالي في المستعرض الخاص بك:
php.net/name_of_function
ليست هناك حاجة لكتابة "  http://www. " ، سيتم إضافتها من تلقاء نفسها .  
إذا كانت الوظيفة موجودة ، فإنك تقع مباشرة على العرض التقديمي. بخلاف ذلك ، يتم إخبارك أن الوظيفة غير موجودة وأنك تعرض على وظائف أخرى لها نفس الاسم تقريبًا.
لذلك إذا أردت معرفة كل شيء عن ذلك mt_rand ، اكتب ما هو موجود في الشكل التالي في شريط العناوين في المتصفح الخاص بي.
web dynamique php
الوصول المباشر إلى الوثائق من شريط عنوان المتصفح
عند التحقق من صحة هذا العنوان ، تصل مباشرةً إلى الصفحة التي تعرض الوظيفة mt_rand  !
سريعة جدا ومريحة ، أليس كذلك؟
عرض وظيفة مباشرة
افترض الآن أنك حددت الوظيفة التي تهمك. سوف تأتي بعد ذلك إلى صفحة نظرة عامة على الوظيفة .
سنتناول حالة الوظيفة mt_rand  : افعل ما قلت لك أعلاه للانتقال مباشرةً إلى الصفحة المتعلقة بهذه الوظيفة.
تحتوي صفحة العرض التقديمي الخاصة بوظيفة ما دائمًا على نفس الشكل ، في الشكل التالي.
web dynamique php
عرض وظيفة mt_rand
ما يهمنا أكثر في هذا هو "كيفية استخدام الوظيفة". يتوافق مع هذه الخطوط:

int mt_rand ( void )
int mt_rand ( int $min, int $max )
هذه الخطوط تصف كيفية استخدامها mt_rand . سوف أعلمك كيفية فك تشفيرها ، لأنه عندما يمكنك قراءتها ، يمكنك استخدام أي وظيفة من وظائف PHP باستخدام doc !

تعلم قراءة دليل


هنا ، يشير دليل المستخدم إلى أن هناك طريقتان لاستخدام الوظيفة: مع أو بدون مُدخلات. تكون المشكلة أكثر تعقيدا مع المُدخلات:

int mt_rand ( int $min, int $max )
دعونا نلقي نظرة على جميع المعلومات التي يحتويها مقتطف الكود هذا.
  • int : تبدأ الوظيفة بالكلمة الرئيسية int . تشير هذه الكلمة الأساسية الأولى إلى ما ترجعه الوظيفة . من بين أشياء أخرى ، يمكننا الحصول على الكلمات الرئيسية التالية:
    • int  : هذا يعني أن الدالة تقوم بإرجاع عدد صحيح.  mt_rand لذلك تقوم بإرجاع عدد صحيح (-8 ، 0 ، 3 ، 12 ، إلخ) ؛
    • float  : تقوم الدالة بإرجاع رقم عشري (مثل 15.2457) ؛
    • number  : ترجع الدالة رقمًا يمكن أن يكون عددًا صحيحًا ( int) أو عشريًا ( float) ؛
    • string  : تقوم الدالة بإرجاع سلسلة أحرف ، وهذا يعني النص. على سبيل المثال "Hello"؛
    • bool  : ترجع الدالة قيمة منطقية ، أي صواب أو خطأ (  trueأو false ) ؛
    • array  : تقوم الدالة بإرجاع صفيف (مجموعة من المتغيرات). أبسط شيء بشكل عام هو القيام بأحد الأشياء print_r ، كما علمتك ، لرؤية كل شيء في هذه المجموعة ؛
    • resource  : ترجع الدالة "مورد" . المورد هو نوع معين من البيانات ، وهو نوع من المتغيرات الفائقة. يمكن أن يكون صورة ، ملف ، إلخ. في الفصل في مكتبة GD على سبيل المثال ، نتعامل مع متغير $image ؛
    • void  : وظيفة إرجاع أي شيء على الإطلاق. هذا هو الحال بالنسبة للوظائف التي تعمل فقط على تنفيذ إجراء والتي لا تحتاج إلى إرجاع المعلومات ؛
    • mixed  : الدالة يمكنها إرجاع أي نوع من البيانات (واحد int، واحد string، ذلك يعتمد ... ) .
  • mt_rand  : هناك هو بسيط جدا ، وهذا هو اسم الوظيفة.
  • (int $min, int $max)  : بين قوسين ، هناك قائمة المُدخلات التي يمكن أن تعطى لهذه الوظيفة. هنا ، يمكننا إعطاء عدد صحيحين ( int) : min و max . يتم استخدامها للإشارة إلى أنك تريد رقمًا عشوائيًا بين 5 و 15 على سبيل المثال. يتم شرح معنى المُدخلات في قسم "قائمة المُدخلات" بالصفحة.
من الممكن أيضًا استدعاء الوظيفة بدون أي مُدخلات ، وهذا ما يعنيه السطر التالي:

int mt_rand ( void )
ولكن بعد ذلك ... ماذا يعني إذا لم نرسل أي مُدخلات؟ ماذا ستفعل الوظيفة؟
إنه مكتوب على الصفحة:
تنويه
يتم الاتصال به بدون وسيطات اختيارية ، min ويقوم بإرجاع رقم عشوائي زائف ، بين 0 و  (  أقصى عدد يتم تعيينه بواسطة PHP  ) . للحصول على رقم بين 5 و 15 ضمناً ، استخدم .maxmt_rand() RAND_MAXmt_rand(5,15)
مثل ماذا ، مجرد قراءة. 
مثال آخر: date
كما يجب أن تعرف الآن كيفية القيام بذلك ، انتقل إلى  date للحصول على وصف الوظيفة.
التعليمات:

string date ( string $format [, int $timestamp])
ترجع الدالة سلسلة أحرف ( string) : هذا هو التاريخ.
يجب أن تُعطى سلسلة أحرف تسمى format (لطلب الشهر ، السنة ، إلخ. هل تتذكر؟ ) .
لاحظ أن هناك مُدخلا ثاني بين قوسين معقوفين ، مما يعني أنها اختيارية. هذا هو int اسمه timestamp . لمعرفة ما يعنيه ، اقرأ وصف المُدخلات.
لذلك عليك دائمًا الانتباه: بعض المُدخلات إلزامية ، والبعض الآخر ليس الزامي (فهي بين قوسين مربعين) ، وتتفاعل الوظيفة بشكل مختلف حسب الحالة. بشكل عام ، يشرح النص الوصفي للوظيفة ما يحدث إذا لم تضع المُدخلات الاختيارية.
اقرأ الأمثلة!
هناك دائمًا أمثلة لتوضيح استخدام الوظيفة. هذا عملي للغاية لأننا نوضح لك كيفية استخدام الوظيفة ، ونحن لا نتردد في عرض الحالات الخاصة التي تتفاعل فيها الوظيفة بشكل مختلف قليلاً.
على سبيل المثال ، mt_rand لما لدينا في الشكل التالي.
web dynamique php
أمثلة على استخدام mt_rand
إذا كان ذلك ممكنًا ، فحاول اختبار الأمثلة المقدمة. يحدث غالبًا أن نفهم بشكل أفضل من خلال الأمثلة التي نجربها لأنفسنا.