PHP updates (#3553)

* Fix PHP getLastEventId example

* Move old Laravel instructions to the bottom of the page

* Explain how to use configureScope vs. withScope

* Add missing unset-user PHP snippet

* Update set-level PHP snippet with realistic code

* Add sensitive data PHP snippets

* Update src/includes/set-context/php.mdx

Co-authored-by: Fiona <[email protected]>

Co-authored-by: Fiona <[email protected]>

Author: stayallive

src/includes/enriching-events/set-context/php.mdx

@@ -1,3 +1,5 @@
+The `configureScope` helper will setup the scope for all events being captured by the Sentry SDK.
+
 ```php
 \Sentry\configureScope(function (\Sentry\State\Scope $scope): void {
   $scope->setContext('character', [
@@ -7,3 +9,18 @@
   ]);
 });
 ```
+
+If you need to modify the scope for a single event, you can use the `withScope` helper instead, which does not keep the scope changes made.
+
+```php
+\Sentry\withScope(function (\Sentry\State\Scope $scope) use ($e): void {
+  $scope->setContext('character', [
+    'name' => 'Mighty Fighter',
+    'age' => 19,
+    'attack_type' => 'melee'
+  ]);
+
+  \Sentry\captureMessage('The fighter is out of energy!');
+  // or: \Sentry\captureException($e);
+});
+```

src/includes/enriching-events/user-feedback/example-widget/php.laravel.mdx

@@ -1,6 +1,33 @@
-For Laravel 5 up to 5.4 you need to open up `App/Exceptions/Handler.php` and extend the
-`render` method to make sure the 500 error is rendered as a view correctly, in 5.5+ this
-step is not required anymore and you can skip ahead to the next one:
+Make sure you've got the JavaScript SDK available:
+
+```html
+<script
+  src="https://browser.sentry-cdn.com/{{ packages.version('sentry.javascript.browser') }}/bundle.min.js"
+  integrity="sha384-{{ packages.checksum('sentry.javascript.browser', 'bundle.min.js', 'sha384-base64') }}"
+  crossorigin="anonymous"
+></script>
+```
+
+Next, create `resources/views/errors/500.blade.php`, and embed the feedback code:
+
+```html {filename:resources/views/errors/500.blade.php}
+<div class="content">
+  <div class="title">Something went wrong.</div>
+
+  @if(app()->bound('sentry') && app('sentry')->getLastEventId())
+    <div class="subtitle">Error ID: {{ app('sentry')->getLastEventId() }}</div>
+    <script>
+      Sentry.init({ dsn: '___PUBLIC_DSN___' });
+      Sentry.showReportDialog({
+        eventId: '{{ app('sentry')->getLastEventId() }}'
+      });
+    </script>
+  @endif
+</div>
+```
+
+For Laravel 5 up to 5.4 there is some extra work needed. You need to open up `App/Exceptions/Handler.php` and extend the
+`render` method to make sure the 500 error is rendered as a view correctly, in 5.5+ this step is not required anymore.
 
 ```php {filename:app/Exceptions/Handler.php}
 <?php
@@ -33,29 +60,3 @@ class Handler extends ExceptionHandler
     }
 }
 ```
-
-Make sure you've got the JavaScript SDK available:
-
-```html
-<script
-  src="https://browser.sentry-cdn.com/{{ packages.version('sentry.javascript.browser') }}/bundle.min.js"
-  integrity="sha384-{{ packages.checksum('sentry.javascript.browser', 'bundle.min.js', 'sha384-base64') }}"
-  crossorigin="anonymous"
-></script>
-```
-
-Next, create `resources/views/errors/500.blade.php`, and embed the feedback code:
-
-```html {filename:resources/views/errors/500.blade.php}
-<div class="content">
-  <div class="title">Something went wrong.</div>
-
-  @if(app()->bound('sentry') && app('sentry')->getLastEventId())
-    <div class="subtitle">Error ID: {{ app('sentry')->getLastEventId() }}</div>
-    <script>
-      Sentry.init({ dsn: '___PUBLIC_DSN___' });
-      Sentry.showReportDialog({ eventId: '{{ app('sentry')->getLastEventId() }}' });
-    </script>
-  @endif
-</div>
-```

src/includes/enriching-events/user-feedback/example-widget/php.mdx

@@ -17,7 +17,7 @@ Make sure you've got the JavaScript SDK available:
 Depending on how you render your templates, the example would be in a simple php file:
 
 ```html
-<?php if (Sentry\State\Hub::getCurrent()->getLastEventId()) { ?>
+<?php if (\Sentry\SentrySdk::getCurrentHub()->getLastEventId()) { ?>
 <script>
   Sentry.init({ dsn: "___PUBLIC_DSN___" });
   Sentry.showReportDialog({

src/includes/sensitive-data/set-tag/php.mdx

@@ -0,0 +1,5 @@
+```php
+\Sentry\configureScope(function (\Sentry\State\Scope $scope) use ($user): void {
+  $scope->setTag('birthday', checksum_or_hash($user->birthday));
+});
+```

src/includes/sensitive-data/set-user/php.mdx

@@ -0,0 +1,9 @@
+```php
+\Sentry\configureScope(function (\Sentry\State\Scope $scope) use ($user): void {
+  $scope->setUser(['id' => $user->id]);
+
+  // or
+
+  $scope->setUser(['username' => $user->username]);
+});
+```

src/includes/set-level/php.mdx

@@ -1,5 +1,7 @@
 ```php
-\Sentry\configureScope(function (\Sentry\State\Scope $scope): void {
+\Sentry\withScope(function (\Sentry\State\Scope $scope): void {
   $scope->setLevel(\Sentry\Severity::warning());
+
+  \Sentry\captureMessage('This is now a warning!');
 });
 ```

src/includes/unset-user/php.mdx

@@ -0,0 +1,5 @@
+```php
+\Sentry\configureScope(function (\Sentry\State\Scope $scope): void {
+  $scope->removeUser();
+});
+```