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

12 Working in a Team

The main goal of this book is to enable you to write code that can be understood, maintained, and extended by you and others. Most of the time, being a PHP developer means that you do not work alone on a project or a tool. And even if you started writing code alone, chances are high that at some point, another developer will join you – be it on a commercial product, or your open source package where other developers start adding new features or bug fixes.

There will always be multiple ways to carry out a task in software development. This is what makes working in a team more challenging when you want to write clean code together. In this chapter, you will find several tips and best practices on how to set up coding standards ...