php postcodes

الرموز البريدية PHP

هذه المكتبة تتعامل مع مختلف المهام ذات الصلة برمز البريدي في المملكة المتحدة.

سمات

• عنوان البحث عن طريق الرمز البريدي
• التحقق من الرمز البريدي
• توليد رموز بريدية صالحة في المملكة المتحدة
• احصل على الرموز الخارجي والداخلية للرمز البريدي

تثبيت

للتثبيت ، فقط قم بتشغيل أمر الملحن التالي.

composer require divineomega/php-postcodes

يثبت

خدمات البحث الرمز البريدي

يتطلب استخدام بعض ميزات استرجاع البيانات التي توفرها هذه المكتبة خدمة البحث عن الرمز البريدي. يدعم حاليًا خدمات البحث عن الرمز البريدي التالي.

• الرموز البريدية المثالية - https://ideal-postcodes.co.uk
• الرمز البريدي في أي مكان (PCA تنبؤ) - https://www.pcapredict.com/
• postcodes.io - http://postcodes.io/

اشترك في موقع الويب المعني إذا كنت بحاجة إلى استخدام هذه الميزات.

يمكنك بعد ذلك استخدام الكود التالي للحصول على كائن خدمة البحث عن الرمز البريدي المناسب.

 $ postcodeLookupService = new  DivineOmega  Postcodes  Objects  IdealPostcodes ( ' API_KEY ' );
// OR
$ postcodeLookupService = new  DivineOmega  Postcodes  Objects  PostcodeAnywhere ( ' API_KEY ' );
// OR
$ postcodeLookupService = new  DivineOmega  Postcodes  Objects  PostcodesIo ();

الاستخدام

الحصول على عناوين عن طريق الرمز البريدي

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

 $ addresses = $ postcodeLookupService -> getAddressesByPostcode ( ' ST163DP ' );

التحقق من صحة الرمز البريدي

يمكنك التحقق من صحة الرمز البريدي في المملكة المتحدة صحيح باستخدام فئة الأداة المساعدة Validator . يظهر أدناه مثال على كيفية القيام بذلك.

 $ validated =  DivineOmega  Postcodes  Utils Validator:: validatePostcode ( ' ST163DP ' );

يرجى ملاحظة أن التحقق من صحة الرمز البريدي غير حساس للحالة.

توليد الرمز البريدي

تتيح لك هذه المكتبة إنشاء رمز بريدي عشوائي وصالح في المملكة المتحدة. هذا يستخدم فئة الأداة المساعدة Generator ، كما هو موضح أدناه.

 $ postcode =  DivineOmega  Postcodes  Utils Generator:: generatePostcode ();

احصل على الرموز الخارجية والداخلية

يسمى الجزء الأول من الرمز البريدي على سبيل المثال PO1 الرمز الخارجي لأنه يحدد المدينة أو المنطقة التي سيتم إرسال الرسالة إليها لمزيد من الفرز. يسمى الجزء الثاني من الرمز البريدي على سبيل المثال 1EB الكود الداخلي.

 $ outwardCode =  DivineOmega  Postcodes  Utils Tokenizer:: outward ( ' ST163DP ' ); // Returns ST16
$ inwardCode =  DivineOmega  Postcodes  Utils Tokenizer:: inward ( ' ST163DP ' ); // Returns 3DP