initial package

Author: rubicon-international

.gitignore

@@ -0,0 +1,28 @@
+### OSX BOOGERS ###
+.DS_Store
+*._DS_Store
+._.DS_Store
+*._
+._*
+._.*
+
+### WINDOWS BOOGERS ###
+Thumbs.db
+
+### Sass ###
+/.sass-cache/*
+.sass-cache
+
+### SUBLIMETEXT BOOGERS ###
+*.sublime-workspace
+
+### PHPSTORM BOOGERS ###
+.idea/*
+/.idea/*
+
+### DIFFERENT TYPE OF MASTER CONFIGS ###
+composer.lock
+.env
+
+### ASSET EXCLUSIONS ###
+vendor/

LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2017 <Jeremy Kenedy>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

composer.json

@@ -0,0 +1,23 @@
+{
+    "name": "jeremykenedy/laravel-exception-notifier",
+    "description": "Laravel exception notifier will send an email of of the error along with the stack trace to the chosen recipients.",
+    "keywords": ["laravel", "exception", "notification", "email"],
+    "license": "MIT",
+    "type": "package",
+    "authors": [
+        {
+            "name": "jeremykenedy",
+            "email": "jeremykenedy@gmail.com"
+        }
+    ],
+    "require": {
+        "php": ">=5.6.4",
+    },
+    "autoload": {
+        "psr-4": {
+            "jeremykenedy\\laravelexceptionnotifier\\": "src/"
+        }
+    },
+    "minimum-stability": "dev",
+    "prefer-stable": true
+}

readme.md

@@ -0,0 +1,56 @@
+# Laravel-Exception-Notifier | A Laravel Excpetions Email Notification [Package](https://packagist.org/packages/jeremykenedy/laravel-exception-notifier) | v0.0.1
+
+[![Total Downloads](https://poser.pugx.org/jeremykenedy/laravel-exception-notifier/d/total.svg)](https://packagist.org/packages/jeremykenedy/laravel-exception-notifier)
+[![Latest Stable Version](https://poser.pugx.org/jeremykenedy/laravel-exception-notifier/v/stable.svg)](https://packagist.org/packages/jeremykenedy/laravel-exception-notifier)
+[![License](https://poser.pugx.org/jeremykenedy/laravel-exception-notifier/license.svg)](https://packagist.org/packages/jeremykenedy/laravel-exception-notifier)
+
+## Introduction
+
+Laravel exception notifier will send an email of of the error along with the stack trace to the chosen recipients. [This Package](https://packagist.org/packages/jeremykenedy/laravel-exception-notifier) includes all necessary traits, views, configs, and Mailers for email notifications upon your applications exceptions. You can customize who send to, cc to, bcc to, enable/disable, and custom subject or default subject based on environment. Built for Laravel 5.2, 5.3, and 5.4+.
+
+## Requirements
+
+* [Laravel 5.2, 5.3, or 5.4 or newer](https://laravel.com/docs/installation)
+
+## Installation
+
+1. From your projects root folder in terminal run:
+
+    ```
+        composer require jeremykenedy/laravel-exception-notifier
+    ```
+
+2. Register the package with laravel in `config/app.php` under `providers` with the following:
+
+   ```
+      jeremykenedy\laravelexceptionnotifier\LaravelExceptionNotifier::class,
+   ```
+
+3. Publish the packages language files by running the following from your projects root folder:
+
+    ```
+        php artisan vendor:publish --tag=laravelexceptionnotifier
+    ```
+
+5. Configure your email settings in the `.env` file.
+
+5. Add the following (optional) settings to your `.env` file and enter your settings:
+
+    * Note: the defaults for these are located in `config/exception.php`
+
+    ```
+        EMAIL_EXCEPTION_ENABLED=false
+        EMAIL_EXCEPTION_FROM=email@email.com
+        EMAIL_EXCEPTION_TO='email1@gmail.com, email2@gmail.com'
+        EMAIL_EXCEPTION_CC=''
+        EMAIL_EXCEPTION_BCC=''
+        EMAIL_EXCEPTION_SUBJECT=''
+    ```
+
+## Screenshots
+
+![Email Notification]( {IMAGE_URL} )
+
+## License
+
+Laravel-Exception-Notifier | A Laravel Excpetions Email Notification Package is open-sourced software licensed under the [MIT license](http://opensource.org/licenses/MIT)

src/.env.example

@@ -0,0 +1,41 @@
+APP_NAME=Laravel
+APP_ENV=local
+APP_KEY=
+APP_DEBUG=true
+APP_LOG_LEVEL=debug
+APP_URL=http://localhost
+
+DB_CONNECTION=mysql
+DB_HOST=127.0.0.1
+DB_PORT=3306
+DB_DATABASE=homestead
+DB_USERNAME=homestead
+DB_PASSWORD=secret
+
+BROADCAST_DRIVER=log
+CACHE_DRIVER=file
+SESSION_DRIVER=file
+QUEUE_DRIVER=sync
+
+REDIS_HOST=127.0.0.1
+REDIS_PASSWORD=null
+REDIS_PORT=6379
+
+MAIL_DRIVER=smtp
+MAIL_HOST=smtp.mailtrap.io
+MAIL_PORT=2525
+MAIL_USERNAME=null
+MAIL_PASSWORD=null
+MAIL_ENCRYPTION=null
+
+PUSHER_APP_ID=
+PUSHER_APP_KEY=
+PUSHER_APP_SECRET=
+
+# Email Expection Settings are optional as defaults are set in config/exceptions.php - below are example values
+EMAIL_EXCEPTION_ENABLED=false
+EMAIL_EXCEPTION_FROM=jeremykenedy@gmail.com
+EMAIL_EXCEPTION_TO='jeremyekenedy@gmail.com,jeremykenedy@gmail.com'
+EMAIL_EXCEPTION_CC=''
+EMAIL_EXCEPTION_BCC=''
+EMAIL_EXCEPTION_SUBJECT=''

src/App/Mail/ExceptionOccured.php

@@ -0,0 +1,68 @@
+<?php
+
+namespace App\Mail;
+
+use Illuminate\Bus\Queueable;
+use Illuminate\Mail\Mailable;
+use Illuminate\Queue\SerializesModels;
+use Illuminate\Contracts\Queue\ShouldQueue;
+
+class ExceptionOccured extends Mailable
+{
+    use Queueable, SerializesModels;
+
+    private $content;
+
+    /**
+     * Create a new message instance.
+     *
+     * @return void
+     */
+    public function __construct($content)
+    {
+        $this->content = $content;
+    }
+
+    /**
+     * Build the message.
+     *
+     * @return $this
+     */
+    public function build()
+    {
+
+        $emailsTo   = str_getcsv(config('exceptions.emailExceptionsTo'),',');
+        $ccEmails   = str_getcsv(config('exceptions.emailExceptionCCto'),',');
+        $bccEmails   = str_getcsv(config('exceptions.emailExceptionBCCto'),',');
+        $fromSender = config('exceptions.emailExceptionFrom');
+        $subject    = config('exceptions.emailExceptionSubject');
+
+        if ($emailsTo[0] == null) {
+            $emailsTo = config('exceptions.emailExceptionsToDefault');
+        }
+
+        if ($ccEmails[0] == null) {
+            $ccEmails = config('exceptions.emailExceptionCCtoDefault');
+        }
+
+        if ($bccEmails[0] == null) {
+            $bccEmails = config('exceptions.emailExceptionBCCtoDefault');
+        }
+
+        if (!$fromSender) {
+            $fromSender = config('exceptions.emailExceptionFromDefault');
+        }
+
+        if (!$subject) {
+            $subject = config('exceptions.emailExceptionSubjectDefault');
+        }
+
+        return $this->from($fromSender)
+                    ->to($emailsTo)
+                    ->cc($ccEmails)
+                    ->bcc($bccEmails)
+                    ->subject($subject)
+                    ->view(config('exceptions.emailExceptionView'))
+                    ->with('content', $this->content);
+    }
+}

src/App/Traits/ExceptionNotificationHandlerTrait.php

@@ -0,0 +1,77 @@
+<?php
+
+namespace App\Traits;
+
+use App\Mail\ExceptionOccured;
+use Mail;
+use Symfony\Component\Debug\ExceptionHandler as SymfonyExceptionHandler;
+use Symfony\Component\Debug\Exception\FlattenException;
+
+trait ExceptionNotificationHandlerTrait
+{
+
+    /**
+     * A list of the exception types that should not be reported.
+     *
+     * @var array
+     */
+    protected $dontReport = [
+        \Illuminate\Auth\AuthenticationException::class,
+        \Illuminate\Auth\Access\AuthorizationException::class,
+        \Symfony\Component\HttpKernel\Exception\HttpException::class,
+        \Illuminate\Database\Eloquent\ModelNotFoundException::class,
+        \Illuminate\Session\TokenMismatchException::class,
+        \Illuminate\Validation\ValidationException::class,
+    ];
+
+    /**
+     * Report or log an exception.
+     *
+     * This is a great spot to send exceptions to Sentry, Bugsnag, etc.
+     *
+     * @param  \Exception  $exception
+     * @return void
+     */
+    public function report(Exception $exception)
+    {
+
+        $enableEmailExceptions = config('exceptions.emailExceptionEnabled');
+
+        if ($enableEmailExceptions === "") {
+            $enableEmailExceptions = config('exceptions.emailExceptionEnabledDefault');
+        }
+
+        if ($enableEmailExceptions) {
+            if ($this->shouldReport($exception)) {
+                $this->sendEmail($exception);
+            }
+        }
+
+        parent::report($exception);
+    }
+
+    /**
+     * Sends an email upon exception.
+     *
+     * @param  \Exception  $exception
+     * @return void
+     */
+    public function sendEmail(Exception $exception)
+    {
+        try {
+
+            $e = FlattenException::create($exception);
+            $handler = new SymfonyExceptionHandler();
+            $html = $handler->getHtml($e);
+
+            Mail::send(new ExceptionOccured($html));
+
+        } catch (Exception $exception) {
+
+            dd($exception);
+
+        }
+    }
+
+
+}

src/LaravelExceptionNotifier.php

@@ -0,0 +1,51 @@
+<?php
+
+namespace jeremykenedy\laravelexceptionnotifier;
+
+use Illuminate\Support\ServiceProvider;
+
+class LaravelExceptionNotifier extends ServiceProvider
+{
+    /**
+     * Bootstrap the application services.
+     *
+     * @return void
+     */
+    public function boot()
+    {
+
+        // Publish Trait
+        $this->publishes([
+            __DIR__.'/App/Traits/ExceptionNotificationHandlerTrait.php' => app_path('Traits/ExceptionNotificationHandlerTrait.php'),
+        ], 'laravelexceptionnotifier');
+
+        // Publish Mailer
+        $this->publishes([
+            __DIR__.'/App/Mail/ExceptionOccured.php' => app_path('Mail/ExceptionOccured.php'),
+        ], 'laravelexceptionnotifier');
+
+        // Publish email view
+        $this->publishes([
+            __DIR__.'/resources/views/emails/exception.blade.php' => resource_path('views/emails/exception.blade.php'),
+        ], 'laravelexceptionnotifier');
+
+        // Publish config file
+        $this->publishes([
+            __DIR__.'/config/exceptions.php' => config_path('exceptions.php'),
+        ], 'laravelexceptionnotifier');
+
+    }
+
+    /**
+     * Register the application services.
+     *
+     * @return void
+     */
+    public function register()
+    {
+        // Update App with Trait
+        $this->app->bind(
+            'App\Traits\ExceptionNotificationHandlerTrait'
+        );
+    }
+}