phpconsole/phpconsole

A detached logging facility for PHP to aid your daily development routine

Friday, April 1, 2016
by legierski
Repository
5 Watchers
38 Stars
2,475 Installations

PHP
4 Dependents
0 Suggesters
4 Forks
3 Open issues
17 Versions
1 % Grown

The README.md

Phpconsole

, _(*1)

What is Phpconsole?

In one sentence, Phpconsole is a detached logging facility for PHP to aid your daily development routine. What does it mean, exactly?, _(*2)

The main aim of Phpconsole is to replace burdensome print_r() and var_dump() functions with something vastly superior., _(*3)

Phpconsole lets you send encrypted (AES-256) data to external server, where the data is processed and displayed in user-friendly form. The code is indented and highlighted and you can see additional information, like the address used to trigger the code, the date and time or the location of the code within your project., _(*4)

You can collaborate on the project with others, just add them to the Organisation and they will have access to all projects within it., _(*5)

Check out product tour and a quick video showing Phpconsole in action., _(*6)

How easy is it to use Phpconsole?

p($foo); // that easy!

Requirements

account on phpconsole.com
internet connection (to send data back to phpconsole.com server)
PHP 5.3.0 or later
cURL

Installation

Simple installation - standalone package

Log into your project at phpconsole.com and click Download phpconsole.php file button, _(*7)
Move phpconsole.php file into your project, _(*8)
Require the file and start using Phpconsole right away:, _(*9)
```
require 'path/to/phpconsole.php';
p('Hello World!');
```
As you can see, there's no need to configure Phpconsole when using the Simple installation flow., _(*10)
(optional, recommended) Download cacert.pem file and put it in the same folder as phpconsole.php - it will allow for API endpoint verification, but it's not required to start using Phpconsole., _(*11)

Advanced installation - Composer / Packagist

Add the following to require within your composer.json file:, _(*12)
```
"phpconsole/phpconsole": "3.*"
```
Execute composer update to pull the package into your project, _(*13)

Place your configuration file into one of these locations:, _(*14)

phpconsole_config.php
app/config/phpconsole.php
app/config/packages/phpconsole/phpconsole/config.php
config/packages/phpconsole/phpconsole/config.php
application/config/phpconsole.php

Update your details in config.php (see "Configuration" section below), _(*15)

Package details: https://packagist.org/packages/phpconsole/phpconsole, _(*16)

Advanced installation - Laravel 4

Add the following to require within your composer.json file:, _(*17)
```
"phpconsole/phpconsole": "3.*"
```
Execute composer update to pull the package into your project, _(*18)

Add config file by executing, _(*19)

php artisan config:publish phpconsole/phpconsole

You will find it in, _(*20)

app/config/packages/phpconsole/phpconsole/config.php

Update your details in config.php (see "Configuration" section below), _(*21)

Configuration

Simple installation doesn't require any configuration. For details about configuring package for Composer / Laravel, see the Configuration file., _(*22)

Usage

Here's how to use Phpconsole:, _(*23)

// basic usage, send to default project
p($foo);

// send to project 'emails'
p($foo, 'emails');

// send to project 'backup' and mark as error
p($foo, array('project' => 'backup', 'type' => 'error'));

You can send several types of snippets:, _(*24)

p($_SERVER);

p('The job has been processed successfully', array('type' => 'success'));

p('Memory usage: '.$memory_usage, array('type' => 'info'));

p('Error: '.$error_message, array('type' => 'error'));

You can always create Phpconsole object yourself:, _(*25)

$phpconsole = new \Phpconsole\Phpconsole;
$phpconsole->send('This is a very important message');

Frequently Asked Questions

Can I use Phpconsole to develop locally?, _(*26)

Totally! Just make sure your server can reach phpconsole.com to send data., _(*27)

How to send data to all projects at once?, _(*28)

$phpconsole = new \Phpconsole\Phpconsole;
$phpconsole->sendToAll('Super important message for all developers!');

Is there a way to install entire Phpconsole locally?, _(*29)

No, unfortunately the only option right now is to use Phpconsole library with phpconsole.com. Worried about privacy? Read "Security/privacy concerns" below., _(*30)

Security/privacy concerns

Phpconsole supports end-to-end AES-256 encryption. You can provide a password using encryptionPasswords variable in your config file, which will be used to encrypt all data before it leaves your server. The data will be decrypted in your browser on phpconsole.com after you provide the password. The password is never sent back to Phpconsole's servers. Decryption happens in your browser before showing data on the screen. Phpconsole will never have access to plain-text version of data sent, it will also never store developer's key used to encrypt/decrypt data., _(*31)

If you have more questions about security of your data, you can reach me at peter@phpconsole.com ., _(*32)

Troubleshooting

Class 'p' not found in..., _(*33)

Make sure you don't use deprecated p::send(), replace it with p()., _(*34)

phpconsole.com doesn't show my data, _(*35)

Starting from version 3.1.0, Phpconsole has a "debug mode" that you can enable by changing debug option in your config file from false to true. When attempting to send data through Phpconsole, a Phpconsole debug info section is going to be appended to your page, showing a log of events in the system (pay attention to the ones highligted) and a bunch of basic information about your setup. Make sure that the config visible there matches what you have in your file., _(*36)

You can always reach out to support@phpconsole.com, attaching the info from the debug mode., _(*37)

Useful links

phpconsole.com - main page, _(*38)

Getting Started Video - Installing Phpconsole in under 2 minutes, _(*39)

Getting Started (with CodeIgniter) - how to set up CodeIgniter framework to work with Phpconsole, _(*40)

Check out our Product Tour., _(*41)

Author

Peter Legierski - peter@phpconsole.com - @peterlegierski, _(*42)

Changelog

See CHANGELOG.md file, _(*43)

License

See LICENSE file, _(*44)

The Versions

01/04 2016

dev-master

9999999-dev http://phpconsole.com

A detached logging facility for PHP to aid your daily development routine

library phpconsole

A detached logging facility for PHP to aid your daily development routine

phpconsole/phpconsole

The README.md

Phpconsole

What is Phpconsole?

How easy is it to use Phpconsole?

Requirements

Installation

Simple installation - standalone package

Advanced installation - Composer / Packagist

Advanced installation - Laravel 4

Configuration

Usage

Frequently Asked Questions

Security/privacy concerns

Troubleshooting

Useful links

Author

Changelog

License

The Versions

dev-master

The Requires

The Development Requires

by Peter Legierski

3.5.1

The Requires

The Development Requires

by Peter Legierski

3.5.0

The Requires

The Development Requires

by Peter Legierski

3.4.0

The Requires

The Development Requires

by Peter Legierski

dev-develop

The Requires

The Development Requires

by Peter Legierski

3.3.0

The Requires

The Development Requires

by Peter Legierski

3.2.2

The Requires

The Development Requires

by Peter Legierski

3.2.1

The Requires

The Development Requires

by Peter Legierski

3.2.0

The Requires

The Development Requires

by Peter Legierski

3.1.1

The Requires

The Development Requires

by Peter Legierski

3.1.0

The Requires

The Development Requires

by Peter Legierski

3.0.3

The Requires

The Development Requires

by Peter Legierski

3.0.2

The Requires

The Development Requires

by Peter Legierski

3.0.1

The Requires

The Development Requires

by Peter Legierski

3.0.0

The Requires