Download the PHP package swow-cloud/xr without Composer

XR

🔔 Subscribe to the newsletter to don't miss any update regarding Chevere.

https://user-images.githubusercontent.com/20590102/153045551-619c74cc-c4ae-41da-b7b6-bd8733e623a2.mp4

🦄 View demo

XR is a dump debug server utility for PHP. No extras required, debug your PHP code anywhere.

Features

• 💎 Colorful, typed, easy-on-the eye dump variable highlight
• ✨ Dump n arguments
• 🐘 One-click PHP server run (no extras required)
• 👻 Filter messages by Emotes
• ✍️ Re-name "XR Session" to anything you want
• 🏁 Resume, Pause, Stop and Clear debug window controls
• 🥷 Keyboard shortcuts for ninjas (Resume R, Pause P, Stop S and Clear C)
• 😊 Export message to clipboard (plain text) or as inline-download PNG image
• 📟 Generates dump backtrace
• ⏸ Pause and resume your code execution (*not implemented)
• 🌚 Dark / 🌝 Light mode follows your system preferences
• 👽 Ephemeral, it doesn't store any persistent data
• 🍒 HTML based (save page, search, shortcuts, etc.)
• 🔥 Uses FiraCode font for displaying beautiful looking dumps ™
• 😅 Handle exceptions (hook or replace your existing handler)

Contributing

Feel free to contribute on issues and discussions with your thoughts in how to improve XR.

Getting started

• Add chevere/xr as a dev dependency in your project:

🚧 Min stability dev

You will require to add this to your composer.json file.

Start the server

The server will be available at http://localhost:27420

Demo

Open the debugger and then run:

XR Helpers

Dump variables

Use xr($var1, $var2,...) to dump any variable from your code.

Topic

Add a topic passing t:.

Emote

Add an emote passing e:.

Flags

Pass bitwise flags to trigger special behavior.

• f: XR_BACKTRACE to dump debug backtrace.

• f: XR_PAUSE to pause code execution (*not implemented).

Send raw message

Use xrr to send a raw message to the server.

💡 xrr also supports flags f arguments.

Exception handling

Use registerThrowableHandler to enable XR to handle throwables.

Alternatively, you can use throwableHandler in any existing exception handler logic:

Error handling

You will require to handle errors as exceptions and from there use Exception handling.

Configuration

Optionally configure XR by creating a file named xr.php in your project directory with the following options:

• enable
  • bool Controls sending messages to the server. Set true to enable, false to disable.
• host
  • string The hostname/IP address where XR server is running.
• port
  • int Port to connect to the host.

The following example is a xr.php file with default settings.

For software providers

If you want to handle XR settings somewhere within your existing application logic (not depend on the xr.php file) you can do:

Docker

See DOCKER.

Message reference

The XR dump server can receive messages from anywhere:

• body - The message raw body (HTML).
• file_path - The file path.
• file_line - The file line.
• emote - emote (emojis/symbols)
• topic - Topic as message context.

License

Copyright 2022 Rodolfo Berrios A.

XR is licensed under the Apache License, Version 2.0. See LICENSE for the full license text.

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.