Download the PHP package oji3t/e2slack without Composer

On this page you can find all versions of the php package oji3t/e2slack. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.

FAQ

After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.

Example:
If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.

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 PHP packages are not free to download and because of that hosted in private repositories. In this case some credentials are needed to access such packages. Please use the auth.json textarea to insert credentials, if a package is coming from a private repository. You can look here for more information.

  • 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.
Please rate this library. Is it a good library?

Example code of oji3t/e2slack

Informations about the package e2slack

概要

例外発生時にSlackに通知するライブラリです．多くのphp開発において利用することが可能です． 最低限の拡張のみを許容し，インストールと幾つかの設定のみですぐに利用できます．機能の追加要望やプルリクエスト，バグ報告は随時受け付けています． 例外発生時に即座に通知を受信できることを是として開発しているため，完全なログは別途記録を行ってください．

利用開始

Slackの設定

Slackのwebhookを利用しているため，そのための設定が必要です．これはこのライブラリのインストールよりも簡単です． 権限のあるアカウントでログインした状態でここにアクセスするとincoming-webhookのインテグレーションを作成でき，遷移先のページにてendpointが確認できるのでそれを控えておいてください． 全てが上手くいっていれば，https://hooks.slack.com/services/XXXXXXXXX/XXXXXXXXX/XXXXXXXXXXXXXXXXXXのようなURLになっているはずです． 権限のないアカウントの場合は権限がありませんというようなエラーメッセージが英語で出てくるので権限のある人に相談してください．

ライブラリのインストール

composerによるインストールのみをサポートしています．以下のコマンドでインストールしてください．

以上で準備は完了です．

利用方法

基本的な利用

phpの例外インスタンスと，slackの設定を引数に渡してください．

autoloadが有効であれば以下の様にも書くことができます．これは，上記のコードと全く同じ動作をします． もちろん，e2slack関数を別途定義していた場合はそちらが優先されるため，あなたのすでに作成されたアプリケーションを破壊することはありません． ただし，その状態でこのパッケージの提供するe2slack関数を利用するとPHPのエラーを引き起こす原因となるので注意してください．

送信する例外の種類によって送信するチャンネルを分けることができます．

設定

インストールして即利用可能であることを是としているため，あまり設定できることは多くありませんが，設定により以下の内容を変更できます． endpointなどは他人に知られるべき情報ではないので，Dotenvなどの利用を推奨します．

  1. endpoint…設定したエンドポイントです．デフォルトはnullです．
  2. channel…メッセージを送信するSlackのチャンネルです．デフォルトは'#general'です．'@user.name'の様に指定することもできます．
  3. username…メッセージを投稿するbotの名前です．デフォルトは'Notification'です．エラーの種類によって変えると便利かもしれません．
  4. icon…メッセージを投稿するbotのアイコンです．画像ファイルのURLまたは絵文字を指定します．デフォルトは可愛らしい絵文字が指定されています．

上記の項目をキーとして第二引数に連想配列で指定してください． また，インスタンスを作成した後で設定を上書きすることも可能です．

また，多くのPHPフレームワークではコンフィグレーション機能やエラーハンドリング機能が付属しているため，それぞれにあわせてうまく利用してください．例えばLaravel5では以下の様にできます．

メッセージ送信エラーのハンドリング

メッセージが送信された場合，sendメソッド並びにe2slack関数は現在のインスタンスを返却します．これは，メソッドチェーンでメッセージを別チャンネルに再送信したい場合などを想定した実装です． 送信になんらかの原因で失敗した場合は，上記のいずれもfalseを返します．送信の失敗を取得する場合は$notification===falseなどとしてください．

注意点

endpointなどの情報は流出しないように丁重に管理してください． パッケージの処理時に内部でエラーが発生した場合に無限ループを発生させる危険性があるため，PHPのException基底クラスにハンドリングしてメッセージを送信するというような実装は行ってはいけません． 上記を含め，当パッケージの利用により発生したいかなる損害も開発者であるTakara Ojiは負いかねますのでご了承ください．

All versions of e2slack with dependencies

PHP Build Version
Package Version
Requires maknz/slack Version ~1.0
Composer command for our command line client (download client) This client runs in each environment. You don't need a specific PHP version etc. The first 20 API calls are free. Standard composer command

The package oji3t/e2slack contains the following files

Loading the files please wait ....