Code Igniter Code Sniffer
Download as PPTX, PDF0 likes2,679 views
CodeSniffer is a PHP package that checks code against a defined coding standard to ensure consistency. It can sniff any PHP file or directory and produce a detailed report of errors and warnings found. Common standards include PEAR, Squiz, PHPCS, and Zend. The document discusses how to install and use CodeSniffer via the command line, generating reports, and running it multiple times to catch all issues. Custom standards can also be created by combining rules from different standards.
Code Igniter Code Sniffer
- 2. TopicCode SnifferThe ins and out of making sure your code is up to a standard of your choosing.
- 4. INTRODUCTIONIn our days we have come to code to our own way. Many of us have preferences of tabs to spaces, how we name public and private variables. Whether to use CamelCases or Underscores. I myself have been a more code as I code and go back to clean up later, be it with documentation, notes, and how my code is presented.Many like myself want to make sure that All of our codebase is the same format, but we don't want to manually run through them. That could be so tedious and repetitive that one can take a whole other development cycle to just review the code they have written.Luckily there is a pear package we can use to alleviate the stress, this package is called PhpCodeSniffer.
- 5. INSTALLING PHP CODE SNIFFER To Install PhpCodeSniffer, follow these steps:Go to your command line and enter the following:pear install PHP_CodeSnifferThen enterPhpcs –ito see the installed Coding Standards
- 6. ABOUT CODE SNIFFERCode Sniffer is used by many Open Source and Private development teams. Code Sniffer can sniff any file or directory you wish. Once it has finished Sniffing you will find a detailed report on all the files you have tested. Also CodeSniffer comes with the prepackaged coding standards (PEAR, Squiz, PHPCS and Zend ), I personally follow the Zend Coding Standards, but you can also customize and create your own coding standard taking bits from all over.
- 7. CODE SNIFFER RESPONSEBellow is a typical report for a CodeSniff.FILE: /home/lorna/phpcs/recipe.class.php--------------------------------------------------------------------------------FOUND 3 ERROR(S) AND 0 WARNING(S) AFFECTING 3 LINE(S)--------------------------------------------------------------------------------10 | ERROR | Variable "prep_time" is not in valid camel caps format13 | ERROR | Spaces must be used to indent lines; tabs are not allowed17 | ERROR | A closing tag is not permitted at the end of a PHP file--------------------------------------------------------------------------------
- 8. HOW TO USE CODE SNIFFERCode Sniffer is run via command line, so if needed please shell into your server. At times it is best to know the path to the directory/project you want to sniff. Personally I create a reports folder within the project so All my files related to that project are together. I also want the full report to be printed / displayed.Here is the line I use to generate the Reports from within the project reports folder:phpcs /full/path/to/project --standard=Zend --report=full -n >> projectName.sniffer.txtnow we target just specific files as follows:phpcs /full/path/to/project/ext/fileW.extension --standard=Zend --report=full -n >> projectName.sniffer.txtnow I use >> to pipe the results into a file but you can remove the the piping to render the results within the terminal/console.
- 9. I GOT MY REPORT NOW WHATNow that you have the report in which ever format you decided as a file or on screen, just follow it's instructions, clear out all the errors and run the command again until there is nothing to report or you are satisfied with the current errors being defined.
- 10. Something to NoteCode Sniffer does not catch all the errors on first pass especially if there are errors, on many cases once some errors clear up another set of errors become apparent and noticeable. It's good use to make sure you run code sniffer a couple of times to validate that your sniffer code is properly sniffed.
- 11. THANKSThanks go to Adil and Rokkan for providing us with the Conference space.
- 12. Next Months TopicVote at: www.meetup.com/codeigniter/PhpUnit and Code Igniter with PHP 5.3Code Sniffer Creating Custom StandardsAnything More important than testing and keeping that code clean.
- 13. General InfoMy Email: albert@albert-rosa.comAIM: albertrosa2000Meetup: www.meetup.com/codeigniter/Rokkan: www.rokkan.com