book

Clean Code in PHP

by Carsten Windler, Alexandre Daubois

October 2022

Beginner to intermediate

264 pages

6h 47m

English

Packt Publishing

Read now

Unlock full access

ContributorsAbout the authorsAbout the reviewers
Who this book is forWhat this book coversTo get the most out of this bookDownload the example code files Download the color images Conventions usedGet in touchShare Your Thoughts
What this book will coverUnderstanding what clean code isThe importance of clean code in teams The importance of clean code in personal projectsSummary
Who decides these things anyway?Best practices – where do they really come from?Design pattern principlesBeing context-awareBeing consistent – get results quickerAbout source code analysis toolsAbout testing and its multiple formsSummary
Understanding codeA bit of historyThe purpose of codeBe understood, not cleverA note on maintainabilityUsing binary operators and octal, hexadecimal, and binary notationsAssigning a variable and using gotosExcessively using commentsUsing ternary comparisonsUsing abbreviations Bringing micro-optimizations to your codeRecoding the methods of the SPL Summary
PHP as an ecosystemChoosing the right librariesA word about semantic versioningWhat is semantic versioning?How to deal with semantic versioningStability versus trendsSummary
Naming and organizational conventionsClass files and interface filesExecutablesWeb assets and resourcesNaming classes, interfaces, and methodsNaming foldersSeparating responsibilitiesEvent dispatchingDemystifying polymorphism – interfaces and abstract classesInterfacesAbstract classesSummary
Old versus new PHPStrict typingError reportingAttributesThe version 8 revolutionMatch syntaxNamed argumentsRead-only classes and propertiesMigrating resources to proper classesProtecting your sensitive arguments from leakingSummary

Technical requirementsSyntax checking and code stylingThe PHP built-in linterPHP CS Fixer: a code snifferStatic Code Analysisphpcpd – the copy and paste detectorPHPMD: the PHP mess detectorPHPStan – a static analyzer for PHPPsalm: A PHP static analysis linting machineIDE extensionsPHP Inspections (EA Extended)IntelephenseSummaryFurther reading
Technical requirementsIntroducing code quality metricsAspects of software quality Code quality metricsGathering metrics in PHPphplocPHP DependPhpMetricsThe pros and cons of using metricsThe prosThe consSummaryFurther reading
Technical requirementsInstalling code quality tools using ComposerInstalling code quality tools using require-devGlobal installationComposer scriptsInstalling code quality tools as phar filesKeeping your phar files organizedManaging phar files using PhiveAdding Phive to your projectSummary
Technical requirementsWhy you need automated testsEasier refactoring with testsTypes of automated testsUnit testsIntegration testsE2E testsThe testing pyramid in practiceAbout code coverageUnderstanding code coverageHow to generate code coverage reportsUsing the @covers annotation What to testSummaryFurther reading
Technical requirementsWhy you need CIThe costs of a bugHow to prevent bugsIntroducing CIThe build pipelineStage 1: Build projectStage 2 – Code analysisStage 3 – TestsStage 4 – DeployIntegrating the pipeline into your workflowBuilding a pipeline with GitHub ActionsGitHub Actions in a nutshellStage 1 – Build projectStage 2 – Code analysisStage 3 – TestsStage 4 – DeployIntegrating the pipeline into your workflowYour local pipeline – Git hooksSetting up Git hooksGit hooks in practiceAdvanced usageExcursion – Adding CI to existing softwareStep by stepAn outlook on CDSummaryFurther reading
Technical requirementsCoding standardsGoing with existing standardsCoding guidelinesExamples of coding guidelinesSetting up guidelinesCode reviewsWhy you should do code reviewsWhat code reviews should coverBest practices for code reviewsEnsuring code reviews are doneDefinition of doneCode reviews conclusionDesign patternsUnderstanding design patternsCommon design patterns in PHPAnti-patternsSummaryFurther reading
Technical requirementsWhy documentation mattersWhy documentation is importantDeveloper documentationCreating documentationText documentsDiagramsDocumentation generatorsInline documentationAnnotations are no codeUnreadable codeOutdated commentsUseless commentsWrong or useless DocBlocksTODO commentsWhen commenting is usefulTests as documentationSummaryFurther reading
Other Books You May EnjoyPackt is searching for authors like you

Content preview from Clean Code in PHP

7 Code Quality Tools

In the previous parts of this book, we learned the basics of clean code. Now, it is time to apply that knowledge to our everyday work. There are literally dozens of tools available for the PHP ecosystem that can help us detect flaws and potential bugs, apply the correct code styling, and generally inform us about quality issues.

To ensure a quick and easy start within the world of code quality tools, this section will introduce you to the most commonly used ones. For each, you will learn how to install, configure, and use it directly on your code. You will also learn about some useful extra features they provide.

We will look at the following groups of tools: