ric_README.html 4.5 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121
  1. <?xml version="1.0" encoding="iso-8859-1"?>
  2. <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
  3. <html xmlns="http://www.w3.org/1999/xhtml">
  4. <head>
  5. <!-- template designed by Marco Von Ballmoos -->
  6. <title></title>
  7. <link rel="stylesheet" href="media/stylesheet.css" />
  8. </head>
  9. <body>
  10. <div align="center"><h1>README</h1></div>
  11. <pre>
  12. =============================================================================
  13. Krumo
  14. version 0.2.1a
  15. =============================================================================
  16. You probably got this package from...
  17. http://www.sourceforge.net/projects/krumo/
  18. If there is no licence agreement with this package please download
  19. a version from the location above. You must read and accept that
  20. licence to use this software. The file is titled simply LICENSE.
  21. OVERVIEW
  22. ------------------------------------------------------------------------------
  23. To put it simply, Krumo is a replacement for print_r() and var_dump(). By
  24. definition Krumo is a debugging tool (for PHP5), which displays structured
  25. information about any PHP variable.
  26. A lot of developers use print_r() and var_dump() in the means of debugging
  27. tools. Although they were intended to present human readble information about a
  28. variable, we can all agree that in general they are not. Krumo is an
  29. alternative: it does the same job, but it presents the information beautified
  30. using CSS and DHTML.
  31. EXAMPLES
  32. ------------------------------------------------------------------------------
  33. Here's a basic example, which will return a report on the array variable passed
  34. as argument to it:
  35. krumo(array('a1'=&gt; 'A1', 3, 'red'));
  36. You can dump simultaneously more then one variable - here's another example:
  37. krumo($_SERVER, $_REQUEST);
  38. You probably saw from the examples above that some of the nodes are expandable,
  39. so if you want to inspect the nested information, click on them and they will
  40. expand; if you do not need that information shown simply click again on it to
  41. collapse it. Here's an example to test this:
  42. $x1-&gt;x2-&gt;x3-&gt;x4-&gt;x5-&gt;x6-&gt;x7-&gt;x8-&gt;x9 = 'X10';
  43. krumo($x1);
  44. The krumo() is the only standalone function from the package, and this is
  45. because basic dumps about variables (like print_r() or var_dump()) are the most
  46. common tasks such functionality is used for. The rest of the functionality can
  47. be called using static calls to the Krumo class. Here are several more examples:
  48. // print a debug backgrace
  49. krumo::backtrace();
  50. // print all the included(or required) files
  51. krumo::includes();
  52. // print all the included functions
  53. krumo::functions();
  54. // print all the declared classes
  55. krumo::classes();
  56. // print all the defined constants
  57. krumo::defines();
  58. ... and so on, etc.
  59. A full PHPDocumenter API documentation exists both in this package and at the
  60. project's website.
  61. INSTALL
  62. ------------------------------------------------------------------------------
  63. Read the INSTALL file.
  64. DOCUMENTATION
  65. ------------------------------------------------------------------------------
  66. As I said, a full PHPDocumenter API documentation can be found both in this
  67. package and at the project's website.
  68. SKINS
  69. ------------------------------------------------------------------------------
  70. There are several skins pre-installed with this package, but if you wish you can
  71. create skins of your own. The skins are simply CSS files that are prepended to
  72. the result that Krumo prints. If you want to use images in your CSS (for
  73. background, list-style, etc), you have to put &quot;%URL%&quot; in front of the image URL
  74. in order hook it up to the skin folder and make the image web-accessible.
  75. Here's an example:
  76. ul.krumo-first {background: url(%url%bg.gif);}
  77. TODO
  78. ------------------------------------------------------------------------------
  79. You can find the list of stuff that is going to be added to this project in the
  80. TODO file from this very package.
  81. CONTRIBUTION
  82. -----------------------------------------------------------------------------
  83. If you download and use and possibly even extend this tool, please let us know.
  84. Any feedback, even bad, is always welcome and your suggestions are going to be
  85. considered for our next release. Please use our SourceForge page for that:
  86. http://www.sourceforge.net/projects/krumo/
  87. </pre>
  88. <p class="notes" id="credit">
  89. Documentation generated on Sun, 02 Dec 2007 09:43:23 +0200 by <a href="http://www.phpdoc.org" target="_blank">phpDocumentor 1.4.0a2</a>
  90. </p>
  91. </body>
  92. </html>