Download the PHP package yii2vn/esms without Composer
On this page you can find all versions of the php package yii2vn/esms. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package esms
ESMS API Client
Đây là component hổ trợ việc tương tác với API từ dịch vụ ESMS. Component này hổ trợ bạn có thể tương tác với các api sau:
- Gửi tin nhắn.
- Gửi gọi thoại (voice call).
- Kiểm tra số dư của bạn trên hệ thống.
- Kiểm tra trạng thái tin nhắn thông qua id tin nhắn.
- Kiểm tra danh sách người nhận thông qua id tin nhắn.
Và để tìm hiểu nhiều hơn về các thông tin của API mời bạn xem thêm tài liệu của ESMS tại đây
Cài đặt
Bạn phải cài đặt ứng dụng này thông qua composer
Sau khi cài đặt composer, thực hiện câu lệnh sau:
Lưu ý đối với những ai sử dụng
windowthì thực hiện câu lệnh sau:
Hoặc thêm:
vào composer.json
Cấu hình app
Bạn có thể khai báo component này vào bên trong cấu hình của hệ thống (app config) để sử dụng nhiều lần mà không cần khai báo lại apiKey và secretKey của ESMS
Ngay sau khi cấu hình xong bạn đã có thể tương tác với API thông qua Yii::$app->eSMS
Cách gửi SMS
Sau đây là phần giới thiệu các phương thức bên trong:
1. Gửi tin nhắn đến 1 số điện thoại:
Với phương thức sendSMS bạn có thể gửi tin nhắn đến một số điện thoại bất kỳ:
2. Gửi tin nhắn đến nhiều số điện thoại cùng nội dung:
Bên cạnh phương thức sendSMS component còn hổ trợ phương thức batchSendSMS dùng để tương tác gửi tin trên nhiều số điện thoại:
3. Gửi tin nhắn đến nhiều số điện thoại khác nội dung:
Một cách khác để sử dụng phương thức batchSendSMS đó là mảng phones truyền vào có khóa chính là số điện thoại còn giá trị chính là tin nhắn muốn gửi:
4. Gửi tin nhắn đến nhiều số điện thoại khác nội dung khi chỉ định:
Và một cách khác nữa để sử dụng phương thức batchSendSMS đó là mảng phones có thể có khóa chính là số điện thoại còn giá trị chính là tin nhắn muốn gửi. Còn những thành phần có giá trị là số điện thoại thì sẽ được gửi chung 1 tin nhắn:
Như bạn thấy lúc này tham trị thứ 2 (param 2) sẽ mang giá trị là tin nhắn CHUNG gửi đến các thành phần trên mảng không có khóa là số điện thoại mà giá trị của nó chính là số điện thoại.
Cách gửi voice call
Sau đây là phần giới thiệu các phương thức bên trong:
1. Gửi cuộc gọi thoại đến 1 số điện thoại:
Với phương thức sendVoiceCall bạn có thể gửi một cuộc gọi thoại đến một số điện thoại bất kỳ:
2. Gửi cuộc gọi thoại đến nhiều số điện thoại cùng nội dung:
Bên cạnh phương thức sendVoiceCall component còn hổ trợ phương thức batchSendVoiceCall dùng để tương tác gửi tin trên nhiều số điện thoại:
3. Gửi cuộc gọi thoại đến nhiều số điện thoại khác nội dung:
Một cách khác để sử dụng phương thức batchSendVoiceCall đó là mảng phones truyền vào có khóa chính là số điện thoại còn giá trị chính là nội dung cuộc gọi muốn gửi:
4. Gửi cuộc gọi thoại đến nhiều số điện thoại khác nội dung khi chỉ định:
Và một cách khác nữa để sử dụng phương thức batchSendVoiceCall đó là mảng phones có thể có khóa chính là số điện thoại còn giá trị chính là nội dung cuộc gọi muốn gửi. Còn những thành phần có giá trị là số điện thoại thì sẽ được gửi cùng một nội dung gọi thoại:
Như bạn thấy lúc này tham trị thứ 2 (param 2) sẽ mang giá trị là nội dung cuộc gọi CHUNG gửi đến các thành phần trên mảng không có khóa là số điện thoại mà giá trị của nó chính là số điện thoại.
Cách kiểm tra trang thái
Tất cả các kết quả trả về từ các phương thức gửi tin sms và gửi cuộc gọi thoại voice call từ API của ESMS đều gửi kèm cho bạn 1 thành phần đó là SmsId bạn hãy lưu nó lại và sử dụng nó để kiểm tra trang thái khi cần thiết. Sau đây là cách kiểm tra trang thái từ SmsId
1. Kiểm tra trang thái tin nhắn (sms) hoặc cuộc gọi thoại (voice call)
2. Kiểm tra danh sách người nhận và trạng thái tin nhắn (sms) hoặc cuộc gọi thoại (voice call)
Cách kiểm tra số dư
Để kiểm tra số dư bạn hãy sử dụng phương thức getBalance. Phương thức này có tham trị (param) $force mặc định sau khi lấy được dữ liệu balance component sẽ cache lại để sử dụng cho lần gọi kế tiếp, nếu như bạn muốn gửi api lấy lại dữ liệu thì hãy thiết lập tham trị này là TRUE
Ví dụ về $force:
Kết quả phản hồi API
Đổi với phương thức sendSMS, sendVoiceCall, getBalance sẽ trả về mảng kết quả theo như tài liệu về API của ESMS nếu như ResponseCode hoặc ResultCode là 100 còn lại sẽ là FALSE. Để truy xuất lỗi thì bạn hãy tương tác với phương thức getError hoặc thuộc tính error để lấy ra lỗi cuối cùng trong quá trình gửi tin.
Đổi với phương thức batchSendSMS, batchSendVoiceCall sẽ trả về tập hợp mảng kết quả có khóa là số điện thoại gửi tin hoặc gọi thoại và giá trị chính là mảng kết quả trả về hoặc là FALSE nếu như ResponseCode hoặc ResultCode trên mảng kết quả khác 100.
Các sự kiện
Các sự kiện được tạo ra nhằm hổ trợ bạn thực hiện một số tác vụ đi kèm như trước và sau khi gửi tin nhắn hoặc trước và sau khi gửi cuộc gọi thoại.
Sau đây là danh sách các sự kiện bên trong lớp ESMS:
EVENT_BEFORE_SEND_SMSsự kiện trước khi gửi tin nhắnEVENT_AFTER_SEND_SMSsự kiện sau khi gửi tin nhắnEVENT_BEFORE_SEND_VOICE_CALLsự kiện trước khi gửi cuộc gọi thoạiEVENT_AFTER_SEND_VOICE_CALLsự kiện sau khi gửi cuộc gọi thoại
