feat: Simplify Laravel instructions (#2388)

Author: dcramer

src/components/pageGrid.tsx

@@ -43,9 +43,10 @@ export default ({ nextPages = false, header }: Props): JSX.Element => {
   );
 
   if (nextPages) {
-    matches = matches.slice(
-      matches.indexOf(matches.find(n => n.path === currentPath))
-    );
+    const currentPage = matches.find(n => n.path === currentPath);
+    if (currentPage) {
+      matches = matches.slice(matches.indexOf(currentPage));
+    }
   } else {
     matches = matches.filter(n => n.path !== currentPath);
   }

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

@@ -0,0 +1,5 @@
+---
+title: Other Versions
+---
+
+<PageGrid />

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

@@ -0,0 +1,63 @@
+---
+title: Laravel 5.x and 6.x
+---
+
+## Install
+
+Install the `sentry/sentry-laravel` package:
+
+```bash
+$ composer require sentry/sentry-laravel
+```
+
+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);
+}
+```
+
+If you're on Laravel 5.5 or later 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,
+),
+```
+
+## Configure
+
+Run:
+
+```shell
+$ php artisan sentry:publish
+```
+
+that creates the Sentry configuration file (`config/sentry.php`).
+
+Afterwards, add your DSN to `.env`:
+
+```shell {filename:.env}
+SENTRY_LARAVEL_DSN=___PUBLIC_DSN___
+```
+
+## Verify Setup
+
+You can easily verify that Sentry is capturing errors in your Laravel application by creating a debug route that will throw an exception:
+
+```php
+Route::get('/debug-sentry', function () {
+    throw new Exception('My first Sentry error!');
+});
+```

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

@@ -1,14 +1,15 @@
 ---
 title: Laravel
 sdk: sentry.php.laravel
+sidebar_order: 0
 redirect_from:
   - /clients/php/integrations/laravel/
   - /platforms/php/laravel/
 ---
 
 Laravel is supported via a native package, [sentry-laravel](https://github.com/getsentry/sentry-laravel).
 
-Sentry supports Laravel 5+.
+This guide is for Laravel 7+. We also provide instructions for [other versions](configuration/other-versions/) as well as [Lumen-specific instructions](configuration/other-versions/lumen/).
 
 ## Install
 
@@ -18,23 +19,8 @@ Install the `sentry/sentry-laravel` package:
 $ composer require sentry/sentry-laravel
 ```
 
-If you're on Laravel 5.5 or later 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`.
 
-**For Laravel 7.x and later:**
-
 ```php {filename:App/Exceptions/Handler.php}
 public function report(Throwable $exception)
 {
@@ -46,19 +32,6 @@ public function report(Throwable $exception)
 }
 ```
 
-**For Laravel 5.x and 6.x:**
-
-```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
 
 Run:
@@ -118,3 +91,5 @@ Set `traces_sample_rate` to a value greater than `0.0` after that, Performance M
 Performance data is transmitted using a new event type called "transactions", which you can learn about in [Distributed Tracing](/performance-monitoring/distributed-tracing/#traces-transactions-and-spans). **To capture transactions, you must install and configure your SDK to set the `traces_sample_rate` option to a nonzero value.** The example configuration above will transmit 100% of captured traces. Be sure to lower this value in production otherwise you could burn through your quota quickly.
 
 Learn more about sampling in [Using Your SDK to Filter Events](configuration/filtering/).
+
+<PageGrid nextPages header="Next Steps" />

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

@@ -1,5 +1,5 @@
 ---
-title: Advanced Usage
+title: Usage
 sidebar_order: 7
 excerpt: ""
 description: "Learn more about automatically reporting errors, exceptions, and rejections as well as how to manually capture errors and enable message capture."