Is This Ever OK?
September 27th, 2008 @ 11:35 pmAs a developer I’m often torn between the concept of “it works” and the concept of “it’s right.” This is no less true than in the following example…
<?php
class Foo
{
public $property;
public function outputProperty($var = null)
{
// Some function processing here.
?>
The value of the property is <?php echo $this->property; ?>
<!-- html here !-->
<?php
}
}
?>
There’s great debate amongst the PHP community about when exiting PHP and printing strict HTML is permissible; this example clearly works (you can test it), but is it right?
In terms of readability, it’s terrible. If you’re in the midst of a class and all of a sudden you’re outputting straight HTML, it can confuse a reader. The best commenting in the world can’t help. Most programs that do code highlighting highlight PHP and echo() statements differently.
But on the other side, if you’re going to do a big long string of PHP, and you want to throw in some javascript, doing this isn’t very practical, especially if you have lots of Javascript and, like me, place your strings in single quotes rather than double quotes.
So what do you think, PHP community? Give me your thoughts.
The original work of Brandon Savage.
Related posts:
Categories: Best Practices, Web Architecture
Web developer, amateur photographer, lover of the outdoors and travel. Expect to find me writing code, hiking or visiting new places. I own Blueprint DC and live in Washington, DC. Follow Me On Twitter!
- The 15 Minute Rule Of Software Development
- Learning Zend Framework: A Case Study
- Why Active Record Isn’t A Bad Design Pattern
- In Defense of Development Practices
- Upgrades In Open Source
- Taking A Look At Propel 1.5
- The Reasons To Attend PHP Conferences
- HipHop For PHP: Who Benefits, Who Doesn’t
- Some Soul Searching
- Cool DateTime Functions In PHP 5.3
While I wouldn’t consider myself someone in a position to tell most people reading this what to do, I think I would pummel my devs if they did this. Partly for readability, partly because it seems off, but mostly because I can be pretty certain that layout and presentation is going to be making its way into your business logic.
One quick solution is to just pull the html out into a new php file and turn it into an include or require. Though even that case you would want to take a serious look at the overall architecture of your site as again you probably have a class trying to do too much.