Laravel 3.0.0 (#5663)

Author: cleptric

src/platforms/php/guides/laravel/configuration/laravel-options.mdx

@@ -89,6 +89,9 @@ You can also configure what is being monitored automatically. These settings hav
     // Indicates if the tracing integrations supplied by Sentry should be loaded
     // See all default integration: https://github.com/getsentry/sentry-laravel/tree/master/src/Sentry/Laravel/Tracing/Integrations
     'default_integrations' => true,
+
+    // Indicates that requests without a matching route should be traced
+    'missing_routes' => false,
 ],
 ```
 

src/platforms/php/guides/laravel/other-versions/index.mdx

@@ -1,8 +1,6 @@
 ---
 title: Other Versions
 description: "Learn about using Sentry with Laravel Lumen or Laravel 4.x/5.x/6.x/7.x."
-redirect_from:
-  - /platforms/php/guides/laravel/configuration/other-versions/
 ---
 
 <PageGrid />

src/platforms/php/guides/laravel/other-versions/laravel4.mdx

@@ -1,7 +1,7 @@
 ---
 title: Laravel 4.x
 description: "Learn about using Sentry with Laravel 4.x."
-sidebar_order: 800
+sidebar_order: 300
 redirect_from:
   - /platforms/php/guides/laravel/configuration/other-versions/laravel4/
 ---

src/platforms/php/guides/laravel/other-versions/laravel5.mdx

@@ -0,0 +1,101 @@
+---
+title: Laravel 5.x
+description: "Learn about using Sentry with Laravel 5.x."
+sidebar_order: 200
+---
+
+<Note>
+
+Laravel 5.x is supported until version 2.14.x of the `sentry/sentry-laravel` package.
+
+</Note>
+
+Laravel is supported using a native package: [sentry-laravel](https://github.com/getsentry/sentry-laravel).
+
+This guide is for Laravel 5.x. We also provide instructions for [the latest Laravel](/platforms/php/guides/laravel/) as well as [Lumen-specific instructions](/platforms/php/guides/laravel/other-versions/lumen/).
+
+
+## Install
+
+Install the `sentry/sentry-laravel` package:
+
+```bash
+composer require "sentry/sentry-laravel:^2.14"
+```
+
+If you're on Laravel 5.5 or higher, the package will be auto-discovered. Otherwise, you will need to manually configure it in your `config/app.php`.
+
+```php {filename:config/app.php}
+'providers' => array(
+    // ...
+    Sentry\Laravel\ServiceProvider::class,
+),
+'aliases' => array(
+    // ...
+    'Sentry' => Sentry\Laravel\Facade::class,
+),
+```
+
+Add Sentry reporting to `App/Exceptions/Handler.php`.
+
+```php {filename:App/Exceptions/Handler.php}
+public function report(Exception $exception)
+{
+    if ($this->shouldReport($exception) && app()->bound('sentry')) {
+        app('sentry')->captureException($exception);
+    }
+
+    parent::report($exception);
+}
+```
+
+
+## Configure
+
+Configure the Sentry DSN with this command:
+
+```shell
+php artisan sentry:publish --dsn=___PUBLIC_DSN___
+```
+
+It creates the config file (`config/sentry.php`) and adds the `DSN` to your `.env` file.
+
+```shell {filename:.env}
+SENTRY_LARAVEL_DSN=___PUBLIC_DSN___
+```
+
+
+## Verify
+
+### Verify With Artisan
+
+You can test your configuration using the provided `sentry:test` artisan command:
+
+```shell
+php artisan sentry:test
+```
+
+### Verify With Code
+
+You can verify that Sentry is capturing errors in your Laravel application by creating a route that will throw an exception:
+
+```php {filename:routes/web.php}
+Route::get('/debug-sentry', function () {
+    throw new Exception('My first Sentry error!');
+});
+```
+
+Visiting this route will trigger an exception that will be captured by Sentry.
+
+
+## Local Development and Testing
+
+When Sentry is installed in your application, it will also be active when you are developing or running tests.
+
+You most likely don't want errors to be sent to Sentry when you are developing or running tests. To avoid this, set the DSN value to `null` to disable sending errors to Sentry.
+
+You can also do this by not defining `SENTRY_LARAVEL_DSN` in your `.env` or by defining it as `SENTRY_LARAVEL_DSN=null`.
+
+If you do leave Sentry enabled when developing or running tests, it's possible for it to have a negative effect on the performance of your application or test suite.
+
+<PageGrid nextPages header="Next Steps" />

src/platforms/php/guides/laravel/other-versions/laravel5-6-7.mdx renamed to src/platforms/php/guides/laravel/other-versions/laravel6-7.mdx

@@ -1,15 +1,12 @@
 ---
-title: Laravel 5.x, 6.x, and 7.x
-description: "Learn about using Sentry with Laravel 5.x, 6.x, and 7.x."
-sidebar_order: 600
-redirect_from:
-  - /platforms/php/guides/laravel/other-versions/laravel5-6/
-  - /platforms/php/guides/laravel/configuration/other-versions/laravel5-6/
+title: Laravel 6.x, and 7.x
+description: "Learn about using Sentry with Laravel 6.x, and 7.x."
+sidebar_order: 100
 ---
 
 Laravel is supported using a native package: [sentry-laravel](https://github.com/getsentry/sentry-laravel).
 
-This guide is for Laravel 5.x, 6.x, and 7.x. We also provide instructions for [the latest Laravel](/platforms/php/guides/laravel/) as well as [Lumen-specific instructions](/platforms/php/guides/laravel/other-versions/lumen/).
+This guide is for Laravel 6.x, and 7.x. We also provide instructions for [the latest Laravel](/platforms/php/guides/laravel/) as well as [Lumen-specific instructions](/platforms/php/guides/laravel/other-versions/lumen/).
 
 
 ## Install

src/platforms/php/guides/laravel/other-versions/lumen.mdx

@@ -1,7 +1,7 @@
 ---
 title: Laravel Lumen
 description: "Learn about using Sentry with Laravel Lumen."
-sidebar_order: 100
+sidebar_order: 400
 redirect_from:
   - /platforms/php/guides/laravel/configuration/other-versions/lumen/
 ---
@@ -16,7 +16,7 @@ This guide is for Laravel Lumen 5+. We also provide instructions for [the latest
 Install the `sentry/sentry-laravel` package:
 
 ```bash
-composer require sentry/sentry-laravel
+composer require "sentry/sentry-laravel:^2.14"
 ```
 
 Register Sentry in `bootstrap/app.php`:

src/platforms/php/guides/laravel/performance/instrumentation/automatic-instrumentation.mdx

@@ -9,4 +9,5 @@ The Laravel integration automatically instruments your application to capture tr
 - Views
 - Queue jobs
 - Database queries
+- Laravel HTTP Client
 - GraphQL operations (when using [Lighthouse](https://lighthouse-php.com/))