Download the PHP package aaemnnosttv/dev-debug without Composer
On this page you can find all versions of the php package aaemnnosttv/dev-debug. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download aaemnnosttv/dev-debug
More information about aaemnnosttv/dev-debug
Files in aaemnnosttv/dev-debug
Package dev-debug
Short Description Development debugging functions for WordPress
License
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package dev-debug
Dev Debug
A WordPress plugin for developing plugins.
Dev Debug provides some handy functions for analyzing your code and giving some helpful feedback.
In order to be available for use in early plugin execution, Dev Debug needs to be included first. It's for this reason that Dev Debug was designed as a MU plugin, but it may also be installed as a normal plugin.
Disclaimer: This plugin is a handy tool. It is not intended as a replacement for a real debugging solution like Xdebug. If you don't know what xdebug can do, drop what you're doing and check that out immediately. You can thank me later :smile:
Basic Usage
Non-persistent Data Capture
Dev Debug's primary feature is essentially a super var_dump. Want to dump the contents of a variable/expression?
Simply use ddprint( $somevariable ); and you will see a nice dump at the bottom of the page.
Example:
Want to label your dump? ddprint( $data, $label ) (label defaults to the datatype of $data ). Useful when capturing many items at a time, eg: within the loop.
Each dump shows up as an individual panel at the bottom of the loaded page, regardless of where you are in WP.
The default dump representation is var_export but you can toggle between var_dump and print_r (I find they each have their uses).
Each dump also has a full comprehensive sexy lookin backtrace with which you can reveal with a toggle button at the top right corner of the panel.
Captured output is suppressed during ajax requests and media uploads to prevent the output from interferring with the expected returned data.
Persistent Capture
Dev Debug also provides two functions for capturing data in circumstances where ddprint() would not work, such during as an ajax request.
sdt()
This function saves the captured data as a transient. It's captured output will appear with other captures as long as the data is still set.
The sdt() capture has a short lifespan of only 2 minutes by default.
ddlog()
This function writes the data to a log file.
By default, the file is located in the wp-content/.htdev-debug.log. The destination directory can be changed with the ddbug/logging/path filter if desired.
Most standard Apache and Nginx configurations include rules to block external access to files that begin with
.htsuch as.htaccessand.htpasswd. The.htdev-debugfile could possibly contain very sensitive information so it is not recommended to be used on production environments, however this filename aims to protect unauthorized access for those that choose to live on the wild side.
Hook Inspection
Ever want to know what the heck is going on during a particular action or filter?
The ddhook function will produce a non-persistent capture of all of the callbacks attached to the given hook.
It can also be configured to listen for a given number of arguments that are passed, and provide an additional capture of the arguments passed to the callback.
Menu Item
Dev Debug also adds an admin menu item for clearing the persistent debug capture if set, and a very accessible list of constants.
Constants with truthy values are green, falsy are gray, and undefined are faded/italic for quick reference. The constant's values can also be seen on hover.
Debug Bar
Dev Debug integrates with the Debug Bar plugin out of the box, by adding a panels to its overlay for showing captured dumps, as well as quick in-app access to viewing the Dev Debug log.
Installation
Dev Debug can be installed in a few different ways.
Via Composer
Use
composer require aaemnnosttv/dev-debug
to add the latest release of the package to your project and install it as an MU plugin.
Via Git
Clone the project into either:
{path-to-wp-content}/mu-plugins{path-to-wp-content}/plugins
git clone [email protected]:aaemnnosttv/dev-debug.git
Manual Installation
- Download the desired release.
- Extract directory into one of the two directories listed above.
- Optionally rename the directory to
dev-debugif it is not already.
Note on installing as a MU plugin
WordPress only loads plugins within the root directory of the mu-plugins directory. It does not recurse into sub-directories as it does with plugins.
This means that you will need to load the main plugin file yourself.
Create a simple MU loader for Dev Debug:
Create a file called load-dev-debug.php within the root of the mu-plugins directory.
Add this code:
The loader file can be named anything, but WordPress will load it in alphabetical order. So if you want Dev Debug functions to be available within another MU plugin, you'll just need to ensure that it loads first.
