#amozesh
#part_4 #part4 #p4

قسمت چهارم از سری آموزش های کتابخانه

مطالب مربوط به این قسمت :

تشریح کلاس BPT در کتابخانه
تشریح متد های اضافه یا ویژه کتابخانه

لینک ترین بیت(نیم بها) :
ix8.ir/p4
لینک مستقیم(تمام بها) :
dl.bpt-proto.site/amozesh/p4.mp4

#amozesh
#part_5 #part5 #p5

قسمت پنجم از سری آموزش های کتابخانه

مطالب مربوط به این قسمت :

ساخت یک ربات ساده با کتابخانه
لینک دانلود مستقیم سورس ربات :
ix8.ir/b5
ربات مربوطه :
@BPT_p5_bot

لینک ترین بیت(نیم بها) :
ix8.ir/p5
لینک مستقیم(تمام بها) :
dl.bpt-proto.site/amozesh/p5.mp4

نسخه 1.08 کتابخانه منتشر شد !!

- پنج وب سرویس جدید اضافه شد.

لیست وب سرویس های جدید :
corona
uupload (یو آپلود - آپلود فایل دریافت لینک مستقیم)
screenshot (گرفتن عکس از سایت)
short (کوتاه کننده لینک)
alexa (رتبه الکسا)

- تغییر در خروجی متد statshere
- تغییر در دیتابیس کتابخانه
- اضافه شدن یک تنظیم جدید به متد start

array_update
در صورت true بودن آپدیت به صورت آرایه و در صورت false بودن آپدیت به صورت آبجکت ارسال میشه.
مقدار پیشفرض true

نکته : این تنظیم روی پراپرتی update تاثیری ندارد و نوع آن همچنان آبجکت است

📄 مستندات و توضیحات
https://bpt-proto.site

نسخه 1.09 کتابخانه منتشر شد !!

- یک وب سرویس جدید اضافه ‌شد.

وب سرویس جدید :
proxy (دریافت پروکسی به صورت رندوم)

- دو متد جدید اضافه شد

لیست متد های جدید :
imges
توصیحات imges : جهت تغییر رنگ تصاویر با فرمت jpg و جهت ساخت کپچا کاربرد دارد. مثال :
imges(['type'=>'CAPTCHA']);
در مثال بالا ربات یک عکس کپچا ارسال می‌کند.
imges(['type'=>'Changer','link'=>"imgeLink",'color'=>'red']);
در مثال بالا ربات عکس مد نظر را می‌گیرد و سپس رنگ تصویر را به قرمز تغییر می‌دهد.

buildBot
توصیحات buildBot :با استفاده از این متد می‌توانید توسط ربات خود یک ربات بسازید. کاربرد اصلی این متد برای طراحی رباتساز با کتابخانه می باشد.

-برای متد های بالا به زودی نمونه سورس جهت یادگیری قرار داده خواهد شد.


-متد start حذف شد.
تکمیلی مورد بالا : از این پس اطلاعات را جهت استارت کتابخانه داخل BPT_handler قرار می‌گیرد.

-دریافت نسخه بیس جدید :
https://bpt-proto.site/BPT/base.php

📄 مستندات و توضیحات
https://bpt-proto.site

👈 سورس ربات مطابق با آخرین ورژن 1.09

- نحوه استفاده از متد های :
dataSave
dataGet
buildBot
imges
eKey
🔺توضیحات هر متد کامنت شده است 🔺

🆑 @BPT_CH

👋 سلام و درود خدمت اعضای گرامی.

- لازم به ذکر است که تمامی دوستانی که از کتابخانه BPT استفاده می‌کنند لطفا فایل BPT.php که در کنار سورس ربات قرار دارد را حذف نمایند و سپس مجددا یکبار دیگر ربات خود را استارت کنند تا آخرین نسخه ی BPT نصب گردد.

در صورتی که از کتابخانه BPT استفاده نکرده اید نیاز به این کار نیست و به صورت خودکار ورژن جدید نصب خواهد شد.

با تشکر از همراهی شما عزیزان.

نسخه 1.10 کتابخانه منتشر شد !!

- دامنه کتابخانه از bpt-proto.site به bpt-proto.ir تغییر کرد

- دامنه وب سرویس ها از poty.fun به poty.ir تغییر کرد

- از حالا شما میتوانید با تنظیم ثابت AUTO_UPDATE آپدیت خودکار کتابخونه رو تنظیم کنید

- دیتابیس sql اضافه شد به ربات ، شما میتوانید نوع دیتابیس و اطلاعات مربوطه رو داخل تنظیمات اعمال کنید

توجه : امکان انتقال اطلاعات از یک نوع دیتابیس به نوع دیگر وجود ندارد و در صورت لزوم باید به صورت دستی صورت گیرد

- پراپرتی db از نوع public اضافه شد ، در صورتی که نوع دیتابیس sql تنظیم شده باشد آبجکت مربوط به کاکنشن دیتابیس را دارد و در صورتی که نوع دیتابیس json تنظیم شده باشد اطلاعات مربوط به نام فایل جیسون را داراست

- مقادیر جدیدی به بخش تنظیمات اضافه شده است :
مقدار db که یک آرایه میگیرد(اختیاری ، نوع پیش فرض : json)
در این آرایه باید مقدار type تنظیم شود که دو حالت میتواند داشته باشد json و sql

در صورتی که json بود نیاز به یک مقدار دیگر به نام file_name دارد(اختیاری ، مقدار پیش فرض : BPT-DB.json)

در صورتی که SQL بود نیاز به پنج مقدار دیگر دارد :
host
آدرس اتصال به دیتابیس(اختیاری ، پیش فرض : localhost)
port
پورت اتصال به دیتابیس(اختیاری ، پیش فرض : 3306)
user
نام کاربر جهت اتصال به دیتابیس(اجباری)
pass
پسورد مربوط به کاربر جهت اتصال به دیتابیس(اجباری)
name
نام دیتابیس جهت اتصال(اجباری)

- در صورتی که تنظیم split_update فعال باشد ، یک نوع آپدیت جدید اضافه شده به اسم somethingelse که به متدی با همین نام توی کلاس هندلر درخواست میده
این نوع تمام آپدیت ها رو شامل میشه به جز
message , edited_message , callback_query , inline_query
همچنین موقع ارسال کل آپدیت رو ارسال میکند!

- متد جدید تلگرام اضافه شد
deleteMyCommands

📄 مستندات و توضیحات
https://bpt-proto.ir

نسخه 1.11 کتابخانه منتشر شد !!

- رفع باگ های گزارش شده

- از این پس میتوانید با ارسال پارامتر token در ورودی متد های تلگرام ، متد ها رو روی ربات دیگری اجرا کنید

نمونه :
$this->getMe(['token'=>$token]);
$this->getWebHookInfo(['token'=>$token]);

📄 مستندات و توضیحات
https://bpt-proto.ir

نسخه 1.12 کتابخانه منتشر شد !!

- رفع باگ های گزارش شده

- اضافه شدن رنگ های زیر به متد imegs برای تغییر رنگ عکس (Changer)
lime (آهکی)
silver (نقره ای)
green (سبز)
crimson (زرشکی)
brown (قهوه ای)

-اضافه شدن پارامتر اختیاری done_text به متد imegs جهت تنظیم کپشن عکس های ارسالی.

-اضافه شدن پارامتر اختیاری model به متد imegs جهت ساخت کپچا
این پارامتر عدد 1 تا 5 را در ورودی دریافت میکند. مثال :
imges(['type'=>'CAPTCHA','model'=>3]);

📄 مستندات و توضیحات
https://bpt-proto.ir

نسخه 2.00 کتابخانه منتشر شد !!

- تغییر استایل جامع کتابخونه

- از این پس محدودیتی برای اجرای سورس روی لوکال هاست نیست ، لازم به ذکر است که محدودیت های تلگرام و کشور ها همچنان پابرجاست

- از این پس شما میتوانید روی http نیز کتابخانه را اجرا کنید ، البته باید در تنظیمات فایل certificate برای ssl را تنظیم کنید
این فایل را میتوانید از سرویس های ارائه دهنده ssl دریافت کنید.

- متد های مشابه بسیار زیادی اضافه شدند
به عنوان مثال :
sendDocument => sendDoc , document , doc
جهت دیدن تمامی متد های مشابه ، به صفحه مربوط به متد در مستندات مراجعه کنید

- از این پس میتوانید متد ها را تقریبا با هر شکلی که دوست دارید استفاده کنید
به عنوان مثال :
sendMessage => send_message , sendmessage , SendMessage , Send_Message , ...

- تنظیمات بسیاری به کتابخانه اضافه شد
جهت دیدن تنظیمات و توضیحات آنها به بخش مستندات -> __construct مراجعه کنید

- از این پس میتوانید نحوه دریافت آپدیت را تنظیم کنید
با استفاده از تنظیم receive در تنظیمات ، جهت دیدن اطلاعات بیشتر به مستندات مراجعه کنید

- از این پس میتوانید دیتابیس ربات را کلا آف کنید
جهت دیدن نحوه انجام و توضیحات بیشتر به مستندات مراجعه کنید

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

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

- از این پس متد های تلگرام شامل 3 پارامتر جدید نیز هستند
پارامتر های forgot,answer,return_array ، توضیحات بیشتر را در بخش مستندات یکی از متد های تلگرام مطالعه کنید

- از این پس کتابخانه به صورت خودکار تبدیل فایل را انجام میدهد
در صورت استفاده از متد هایی مانند sendPhoto ، اگر تنها آدرس فایل لوکال را در فیلد مربوطه ارسال کنید خود کتابخانه به صورت خودکار آن را قابل استفاده جهت تلگرام می کند.

- از این پس کتابخانه مقدار های پیشفرض بیشتری به صورت خودکار تنظیم میکند
این مقدار ها در صفحه مستندات مربوط به متد به صورت اختیاری ثبت شده اند

- لاگر ارتقا یافت
از این پس نوع لاگ را تعیین میکند

- 6 متد ویژه جدید اضافه شد
متد های :
catchFields
isToken
isUsername
ipInRange
isTelegram
isCloudFlare
توضیحات مربوط به متد ها را در صفحه مستندات مربوطه مطالعه کنید


- به ورژن 5.5 ای پی آی تلگرام ارتقا یافت
تمامی متد های جدید تلگرام اضافه شد.

- کامنت به متد های ویژه اضافه شد
جهت راحت تر شدن خواندن سورس کتابخانه و همچنین جهت کمک به کاربرانی که از IDE ها استفاده میکنند

- قالب سایت اصلی تغییر کرد

- مستندات کامل شد و قالب آن نیز تغییر کرد
مستندات فارسی همچنان غیرقابل دسترس است

- متد های buildBot و imges در نسخه آینده حذف خواهند شد
توصیه می شود که اقدامات مربوطه هر چه زودتر انجام شود

لازم به ذکر است که سورس های منطبق با ورژن های قبل مانند 1.12 بدون نیاز به تغییری همچنان کار خواهند کرد ولی بهتر است عملکرد سورس هایتان را بررسی کنید.

📄 مستندات و توضیحات
https://bptlib.ir

نسخه 2.01 کتابخانه منتشر شد !!

- رفع باگ های گزارش شده

- کتابخونه به ورژن 5.6API ارتقا یافت

- متد های imges و buildbot به صورت کامل حذف شدند.

- از این پس میتوانید متد های تلگرامی که در کتابخانه نیست را نیز فرابخونید. (تنها در مواقعی که تلگرام متدی را اضافه میکند که تا آن لحظه کتابخانه آن را اضافه نکرده است به کار می آید) لازم به ذکر است که این درخواست ها از قابلیت های کامل کردن مقادیر پیشفرض یا بررسی مقادیر اجباری برخوردار نمیباشد ولی همچنان میتونید از حالت های اضافه مانند ارسال مستقیم در جواب وب هوک استفاده کنید

- از این پس میتوانید آرایه و آبجکت را نیز بدون نیاز به تبدیلشون به جیسون به صورت مستقیم به متد های تلگرام پاس دهید
مانند کیبرد ها و یا نتایج اینلاین
نمونه ارسال آپدیت به صورت مستقیم :

$this->send(['text'=>$update]);

- تعدادی فیلد قابل دریافت به متد catchFields اضافه شد
name (نام کاربر)
last_name (نام خانوادگی کاربر)
username (یوزرنیم کاربر)
group_name (نام گروه)
group_username (یوزرنیم گروه)
update_type (نوع آپدیت دریافتی)
url (لینک همین فایل)

- پارامتر url متد setWebhook اختیاری شد و مقدار پیش فرض آن لینک فایل در حال اجرا است

- تغییری در بخش ارتباط با تلگرام انجام شد که باعث می شود سرعت درخواست ها مخصوصا در تعداد بالا بیشتر شود(تا سقف 3 برابر)
البته تغییری در سرعت درخواست های تعداد پایین ایجاد نخواهد شد

📄 مستندات و توضیحات
https://bptlib.ir

نسخه 2.02 کتابخانه منتشر شد !!

- رفع باگ های گزارش شده

- کتابخونه به ورژن 6.0API ارتقا یافت

- متد های جدید تلگرام به صورت کامل اضافه شدند . لیست متد ها :
setChatMenuButton
getChatMenuButton
setMyDefaultAdministratorRights
getMyDefaultAdministratorRights
answerWebAppQuery
همچنین برای هر متد حداقل یک متد مشابه اضافه شد که میتوانید در صفحه مستندات هر متد آنها را مشاهده کنید

- از این پس در صورتی که آپدیت مسیج یا ادیت مسیج دریافت شود و متن دستور باشد ، 3 مقدار جدید به آپدیت اضافه می شود
commend
که شامل دستور خالی می شود
commend_username
که شامل یوزرنیم دستور می شود(در صورت عدم وجود ، این مقدار اضافه نخواهد شد)
comment_payload
شامل پیلود یا همان متن بعد از دستور می شود(در صورت عدم وجود ، این مقدار اضافه نخواهد شد)
به عنوان مثال
/start@examplebot user_id
در اینجا

commend => '/start'
commend_username => 'examplebot'
commend_payload => 'user_id'

می باشد.

نکته : لازم به ذکر است که این قابلیت تنها در صورت فعال بودن وب هوک عمل خواهد کرد.

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

- یک آرگومان جدید به متد isToken به اسم verify اضافه شد ، در صورتی که مقدار آن را برابر با true قرار دهید ، توکن ارسالی رو با تلگرام هم چک خواهد کرد.
اطلاعات بیشتر را در صفحه مستندات مربوط به متد مطالعه کنید.

- دو متد ویژه جدید اضافه شد

modeEscape
که وظیفه همخوان کردن متن با parse_mode های مختلف را دارد
isJoined
که عملکردی مشابه ولی متفاوت با متد قدیمی jChecker دارد ، در این متد تنها true یا false دریافت خواهید کرد.

- متد objectToArrays در ورژن آینده حذف خواهد شد.
به جای آن از قابلیت کست کردن خود زبان استفاده کنید
$array = (array) $object;

- در اسامی پارامتر های متد checkPhone و متد های خانواده forward تغییر نامی اجرا شد ، پشتیبانی از نام های قدیم در ورژن آینده حذف خواهد شد.

- به متد های خانواده forward یک آرگومان به اسم forward اضافه شد که در صورت مقدار false دادن به آن ، به شکل بی نام ارسال خواهد شد

- یک تغییر در بخش مدیریت ورژن کتابخانه اعمال شد ، از این پس آپدیت های رفع باگ به محض آماده شدن تحت همان ورژن فعلی اعمال خواهند شد(در پیام اصلی ورژن فعلی نوشته خواهند شد)

نکته مهم : از ورژن 2.03 ، حداقل ورژن php مورد نیاز برای اجرای کتابخانه به 7.4 ارتقا خواهد یافت و در نسخه 2.04 و یا نهایتا 2.05 حداقل ورژن به 8.0 ارتقا می یابد ، پس بهتر است که سورس های خود را در صورت نیاز به روز کنید.

پ.ن : 5 ماه دیگر نسخه 7.4 به پایان خود میرسد و دیگر هیچ گونه پشتیبانی از سمت توسعه دهندگان php نخواهد داشت ، همچنین از 5 ماه دیگر ورژن 8.0 نیز آپدیت نخواهد شد و فقط آپدیت های مربوط به رفع باگ را دریافت خواهد کرد.

نسخه 2.021 به جهت رفع باگی در بخش دیتابیس منتشر شد

📄 مستندات و توضیحات
https://bptlib.ir

نسخه 2.03 کتابخانه منتشر شد !!

- رفع باگ هاش گزارش شده

- ارتقا به API نسخه 6.3

- حداقل ورژن پشتیبانی شده php به ورژن 7.4 ارتقا یافت

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

getForumTopicIconStickers
createForumTopic
editForumTopic
closeForumTopic
reopenForumTopic
deleteForumTopic
unpinAllForumTopicMessages
getCustomEmojiStickers

همچنین برای هر متد حداقل یک متد مشابه اضافه شد که میتوانید در صفحه مستندات هر متد آنها را مشاهده کنید

- متد objectToArrays حذف شد
به جای آن از قابلیت کست کردن خود زبان استفاده کنید
$array = (array) $object;

- دو تنظیم جدید اضافه شد
cloudFlare
پشتیبانی از cdn شرکت cloudFlare

arvanCloud
پشتیبانی از cdn شرکت arvanCloud

نکته مهم : از ورژن 2.04 ، حداقل ورژن php مورد نیاز برای اجرای کتابخانه به 8.0 ارتقا خواهد یافت ، پس بهتر است که سورس های خود را در صورت نیاز به روز کنید.

پ.ن : نسخه 7.4 به پایان خود رسیده است و دیگر هیچ گونه پشتیبانی از سمت توسعه دهندگان php ندارد ، همچنین ورژن 8.0 از این به بعد فقط آپدیت های مربوط به رفع باگ را دریافت خواهد کرد


📄 مستندات و توضیحات
https://bptlib.ir

بعد از مدت ها نسخه مولتی فایل کتابخانه آماده شد !!

🔱 پیشنهاد می شود که به جای نسخه عادی کتابخانه از این نسخه استفاده کنید.

ویژگی های نسخه مولتی فایل :
- پشتیبانی از composer
میتوانید با زدن دستور زیر از کتابخانه استفاده کنید
composer require bpt/bpt-multi

- پشتیبانی از حالت تک فایل با استفاده از phar
همچنین میتوانید مانند قدیم بدون composer و به شکل تک فایل از آن استفاده کنید

- داکیومنت تحت خود کتابخانه
داشتن داکیومنت برای تلگرام و خود کتابخانه که شمارا از مراجعه به سایت بی نیاز می کند

- دارای قابلیت IDE friendly
برنامه های IDE راهنمایی های بسیاری را هنگام استفاده از کتابخانه به شما نمایش میدهند(برای متد ها ، آپدیت ها و ...)

- استفاده از روش های جدید برای برقراری امنیت

- دیتابیس بهینه شده
تغییر کلی دیتابیس JSON که باعث بهینه تر شدن و ساده تر شدن آن شده
بقیه نوع ها فعلا پشتیبانی نمی شود.

- روش های متنوع تر برای فراخوانی متد های تلگرام

telegram::sendMessage('hello');

request::sendMessage('hello');

BPT::sendMessage('hello');

$this->sendMessage('hello');
در کلاس هندلر

$BPT->sendMessage('hello');
متغیر $BPT یک شی از کلاس BPT است

پارامتر ها را به شکل های زیر نیز میتوان ارسال کرد :

telegram::sendMessage(['text' => 'hello']);

telegram::sendMessage(text: 'hello');

- مهم ترین مزیت
آپدیت ها و امکانات بسیار زیادی برای این نسخه در برنامه هست و این در حالیه که نسخه تک فایل تقریبا تمام آپدیت های آن زده شده و قابلیت جدیدی که قابل زدن باشد ندارد

📄 مستندات و توضیحات
https://bptlib.ir/multi

نسخه 1.3.0 کتابخانه مولتی فایل منتشر شد !!

- پشتیبانی از دیتابیس mysql اضافه شد

مشاهده تغییرات : لینک
گیت هاب : لینک

نکته : تنها ورژن ها و تغییرات مهم کتابخانه مولتی فایل در کانال اعلام می شود

نسخه 1.3.1 جهت رفع باگ منتشر شد

📄 مستندات و توضیحات
https://bptlib.ir/multi

نمونه سورس کد جهت کار با کتابخانه مولتی فایل

ربات پیام رسان متصل به دیتابیس با استفاده از کلاس mysql خود کتابخانه

📄 مستندات و توضیحات
https://bptlib.ir/multi

نسخه 1.6.0 کتابخانه مولتی فایل منتشر شد !!

- متد fastClose به کلاس webhook اضافه شد

- کلاس crypto برای استفاده از پرداخت های مبتنی بر ارز دیجیتال اضافه شد (nowPayments)

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

- پشتیبانی از کتابخانه jdf به صورت داخلی اضافه شد


مشاهده تغییرات کامل : لینک
گیت هاب : لینک

نکته : تنها ورژن ها و تغییرات مهم کتابخانه مولتی فایل در کانال اعلام می شود

نسخه 1.6.1 جهت رفع باگ منتشر شد

📄 مستندات و توضیحات
https://bptlib.ir/multi

نسخه 1.8.0 کتابخانه مولتی فایل منتشر شد !!

- مستندات کتابخانه مولتی فایل تکمیل شد و از لینک پایین پیام میتوانید مشاهده کنید.

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

- دو کلاس جدید به نام های idpay و zarinpal برای پرداخت های ریالی اضافه شد

- تنظیمات جدیدی به کتابخانه اضافه شد

default_parse_mode
default_protect_content
ignore_updates_older_then

- پشتیبانی از order_by و group_by به متد های کلاس mysql اضافه شد

مشاهده تغییرات کامل : لینک
گیت هاب : لینک

نکته : تنها ورژن ها و تغییرات مهم کتابخانه مولتی فایل در کانال اعلام می شود

📄 مستندات و توضیحات
https://bptlib.ir/multi