PHP Starter http://phpstarter.net PHP Tips & Tools From Starters to Experts Wed, 17 Mar 2010 14:00:24 +0000 http://wordpress.org/?v=2.9.2 en hourly 1 Making Google Static Maps a Little More Dynamic with PHP http://phpstarter.net/2010/03/making-google-static-maps-a-little-more-dynamic-with-php/ http://phpstarter.net/2010/03/making-google-static-maps-a-little-more-dynamic-with-php/#comments Wed, 17 Mar 2010 14:00:24 +0000 Andrew http://phpstarter.net/?p=501
  • Merge Image Layers in PHP
    • ]]>     If you have messed with the Google Maps API, you know that the JavaScript and API keys can be a real headache. Yes, there are very complex implementations that you can use, but what if you want…just a map? If you want just a map with no dynamic interface, Google Static Maps is just for you. I will show how easy it is to use, and then spice it up with some PHP-powered enhancements.

    Check out how easy this is. If I want a map centered at a my zip code, I can create a JPEG image for that area with this link:

    http://maps.google.com/maps/api/staticmap?sensor=false&center=46311&zoom=14&size=600x400

    And it generates this:

    No API keys, no JavaScript, and the URL is even short enough to not have to wrap on the page. As long as you don’t need the typical panning and zooming features, this is the best option. There are a limited but practical set of features including map types (satellite, hybrid, regular, etc), markers, lines, shapes, custom icons, and all in different image formats. View the Google Static Maps API page for the full details.

    Making it a Little More Dynamic

    This is a site on PHP. I can’t show you how to create static maps and leave it at that. There are several good reasons why we might want to dynamically generate that URL.

    Simple “You Are Here” Map

    For starters, how about a map that shows your local area based on your IP address geolocation? This sample below uses the code from a previous article that showed how to determine the geographic location from any IP address.

    Run This Example

    <?php

/* replace with your own DB connection code */
require('../includes/database.php');
$db = db_connect();

/* get the IP address and make sure it is an unsigned integer */
$ip = sprintf('%u', ip2long($_SERVER['REMOTE_ADDR']));

/* fetch the location id and info */
$query = "SELECT CityLocation.* FROM CityBlocks INNER JOIN CityLocation ON CityLocation.locId = CityBlocks.locId WHERE $ip BETWEEN CityBlocks.startIpNum AND CityBlocks.endIpNum LIMIT 1";
$result = mysql_query($query, $db) or die(mysql_error());
$location = mysql_fetch_assoc($result);

?>
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
<html>
<head>
<title>Static Map for Your Location</title>
</head>
<body>
<h2>Static map for your town:</h2>
<p>If you are placed in the middle of an ocean, your IP address is probably not in the database.  The blue marker is your specific IP location (probably not exact).</p>
<img src="http://maps.google.com/maps/api/staticmap?sensor=false&center=<?=$location['postalCode']?>&markers=color:blue|<?=$location['latitude']?>,<?=$location['longitude']?>&zoom=13&size=600x400" />

<h2>Details from IP GeoLocation:</h2>
<pre><?php var_dump($location); ?></pre>
</body>
</html>

    Show Your Position With Other Objects

    We already know how to find a list of the closest items in our area from this post: Locate the Nearest Radar Station and Display Radar Images. Now, let’s apply it to generating a Static Google Map. This uses the “Implicit Positioning” feature where you can just list a bunch of points, and the map will automatically create a zoom level and center based on the created points.

    Run This Example

    <?php

/* replace with your own DB connection code */
require('../includes/database.php');
$db = db_connect();

/* get the IP address and make sure it is an unsigned integer */
$ip = sprintf('%u', ip2long($_SERVER['REMOTE_ADDR']));

/* fetch the location id */
$query = "SELECT locId FROM CityBlocks 
			WHERE $ip BETWEEN startIpNum AND endIpNum LIMIT 1";
$result = mysql_query($query, $db) or die(mysql_error());
$row = mysql_fetch_assoc($result);

/* now fetch the location */
$locId = $row['locId'];
$query = "SELECT * FROM CityLocation WHERE locId = $locId LIMIT 1";
$result = mysql_query($query, $db) or die(mysql_error());
$location = mysql_fetch_assoc($result);

/* offset the coordinates by 3, and find the closest station */
$lat = $location['latitude'] + 3;
$lon = $location['longitude'] - 3;
$query = "SELECT *, SQRT(POW(69.1 * (lat - $lat), 2) + 
			POW(69.1 * ($lon - lon) * COS(lat / 57.3 ), 2 )) AS distance 
			FROM RadarSites ORDER BY distance ASC LIMIT 5";
$result = mysql_query($query, $db) or die(mysql_error());

$qs = '';
for ($i = 0; $i < mysql_num_rows($result); $i++)
{
	$row = mysql_fetch_assoc($result);
	$rows[] = $row;
	
	/* remember - we want roughly the center of the radar coverage, not the top-left corner */
	$lat = $row['lat'] - 3;
	$lon = $row['lon'] + 3;
	
	/* forming the query string for the image URL */
	$markers[] = '&markers=color:blue|label:' . $i . '|' . $lat . ',' . $lon;
}

$markers = implode('', $markers);

?>
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
<html>
<head>
<title>Static Map for Your Location</title>
</head>
<body>
<h2>5 Closest Radar Sites to You</h2>
<p>Red marker is you.</p>
<img src="http://maps.google.com/maps/api/staticmap?sensor=false&maptype=roadmap<?=$markers?>&markers=color:red|<?=$location['latitude']?>,<?=$location['longitude']?>&size=600x400" />

<h2>Details from IP GeoLocation:</h2>
<pre><?php var_dump($location); ?></pre>

<h2>Radar Sites:</h2>
<pre><?php var_dump($rows); ?></pre>
</body>
</html>

    These examples are meant to get your creative juices flowing. Have some other cool concepts for Google Static Maps? Post them below.

    Related posts:

    ]]>     http://phpstarter.net/2010/03/making-google-static-maps-a-little-more-dynamic-with-php/feed/ 3     Parse ZFP (Zone Forecast Product) Data in PHP – Option 1 http://phpstarter.net/2010/03/parse-zfp-zone-forecast-product-data-in-php-option-1/ http://phpstarter.net/2010/03/parse-zfp-zone-forecast-product-data-in-php-option-1/#comments Wed, 03 Mar 2010 14:00:59 +0000 Andrew http://phpstarter.net/?p=449
  • Loading INI Files in PHP
    • ]]>     In a previous article, I covered 5 Sources of Free Weather Data for your Site, but did not provide any actual code to use the data. Since then, I covered sources #1 and #2. None of these sources had any English-formed forecasts. For that, we have to go to the Zone Forecast Product, but we don’t have the luxury of XML here. There is a healthy bit of RegEx and string manipulation, but you can do it!

    Where to Get the Data

    The data is available by browsing the http://www.weather.gov/data/ directory. Here, you will find a whole set of products available. To access the ZFP data, you need to browse the http://www.weather.gov/data/XXX/ZFPXXX directory where ‘XXX’ is the code for the local station from where the data is to be retrieved from. For example, if I wanted the ZFP data for KLOT (Lockport, IL), I would call up http://www.weather.gov/data/LOT/ZFPLOT.

    There is an exception to this rule, however. If you look at http://www.weather.gov/data/AFC/, they show the ZFP for two areas. I think some of these are like this because one office is forecasting for to areas or something (correct me in the comments if I’m wrong). So that formula above is more of a guideline for finding the right link for your area, but I found it to be 95% accurate. (That’s still an ‘A’, right?)

    Understanding the Big Picture

    zfp_01

    Click on the thumbnail for the explained section of this data. Starting at the top is the header. We don’t use this. It contains the station ID and the type of product this is – we know that already. It also contains the release time. Although that is significant, that same information is in the header of the individual forecasts as well, so I will be discarding that in this example.

    The second yellow box is the header for that specific forecast zone. We will be using some data from this. The zone code is the most critical because we need to know for which zone this forecast is for. The only other piece of information in this box that I use is the Release Time, which is when the forecast was released (ironic). This block of information is repeated at the top of every forecast in the file.

    Below the second yellow box is the actual forecast data, which is the meat of what we are looking for. Below that is the separator, which is means that the code block for the next forecast zone is next, and so on…

    Breaking up the Forecasts

    We only want to deal with one forecast zone at a time, so lets break them up. First, I need to get rid of that pesky header at the top of the file. We do that by splitting the data by the double line breaks, and removing that first paragraph from the resulting array. Then, join it back together.

    /* remove the file header */

/* $data = {text from http://www.weather.gov/data/LOT/ZFPLOT} */

$data = trim($data);
$data = explode("\n\n", $data);
unset($data[0], $data[1]);
$data = implode("\n\n", $data);

    Now, we can split of the zone forecasts. We simply split the text by the separator (‘$$’), and keep the forecasts in an array.

    /* separate the forecasts */

/* $data = {result from previous example} */

$data = explode('$$', $data);
/* trim off any extra line breaks */
$data = array_map('trim', $data);

    Perfect. Now we have an array or forecasts with their respective header block.

    Parsing the Zone Codes

    This is the hardest part of understanding the data. We need to know for which geographical area the forecast is for. Most zone forecasts are only for one zone, but it is possible that it may be for more than one. In the above example, the zone code is ILZ014, which is zone 14 of Illinois. Unfortunately, the zone code & purge date line can be as complicated as ILZ001>003-005-IAC045-163-051200-, which is Illinois zone 1, 2, 3, 5 as well as Iowa counties 45 and 163. For the full specs on how to understand this, see the Universal Geographic Code specifications.

    Before we can do anything, we need to find the zone codes. To do that, we need to use one heck of a regular expression, found on line 8 of the sample below. This is what I used to verify that I am finding everything correctly.

    Run This Example

    <?php

/* get the forecast from a local cache */
/* http://www.weather.gov/data/LOT/ZFPLOT */
$data = file_get_contents('ZFPIND.txt');

/* the regular expression to find all the location codes */
$regex = '/(([A-Z]{2})(C|Z){1}([0-9]{3})((>|-)[0-9]{3})*)-/';

/* for this example, we are doing a replacement to show we found everything...
	normally, something like preg_match() would be used */
$data = preg_replace($regex, '<span style="background: #ff0; ">' . "\${1}" . '</span>-', $data);

/* do I really need to explain this? */
echo '<pre>' . $data . '</pre>';

/**
 * Why do I comment out the PHP closing tag?
 * See: http://phpstarter.net/2009/01/omit-the-php-closing-tag/
 */
/* ?> */

    We’re not done with this yet. As you can see from the Universal Geographic Code reference page, they like to make shortcuts. For example, they will use INZ021-028>031 instead of INZ021-INZ028-INZ029-INZ030-INZ031. From a programming standpoint, I think we both know which is better to understand. When I put this data in a database, I need to be able to query a specific location and see if there is data for it. So, if I store it as INZ021-028>031, how do I query for zone 29? These ranges will have to be expanded.

    I’m not going to go into great detail on how to do this…I will just provide a couple functions to do it. Call parse_zones() like I do at line 69, and it will take care of the rest.

    Run This Example

    <?php

/**
 * The NWS combines does not repeat the state code for multiple zones...not good for our purpose
 * All we want to do here is convert ranges like INZ021-028 to INZ021-INZ028
 * We will also call the function to expand the ranges here.
 * See: http://www.weather.gov/emwin/winugc.htm
 */
function parse_zones($data)
{
	/* first, get rid of newlines */
	$data = str_replace("\n", '', $data);
	
	/* split up individual states - multiple states may be in the same forecast */
	$regex = '/(([A-Z]{2})(C|Z){1}([0-9]{3})((>|-)[0-9]{3})*)-/';
	
	$count = preg_match_all($regex, $data, $matches);
	$total_zones = '';
	
	foreach ($matches[0] as $field => $value)
	{
		/* since the NWS thought it was efficient to not repeat state codes, we have to reverse that */
		$state = substr($value, 0, 3);
		$zones = substr($value, 3);
		
		/* convert ranges like 014>016 to 014-015-016 */
		$zones = expand_ranges($zones);
		
		/* hack off the last dash */
		$zones = substr($zones, 0, strlen($zones) - 1);
		$zones = $state . str_replace('-', '-'.$state, $zones);
		
		$total_zones .= $zones;
	}
	
	
	$total_zones = explode('-', $total_zones);
	return $total_zones;
}

/**
 * The NWS combines multiple zones into ranges...not good for our purpose
 * All we want to do here is convert ranges like 014>016 to 014-015-016
 * See: http://www.weather.gov/emwin/winugc.htm
 */
function expand_ranges($data)
{
	$regex = '/(([0-9]{3})(>[0-9]{3}))/';
	
	$count = preg_match_all($regex, $data, $matches);
	
	foreach ($matches[0] as $field => $value)
	{
		list($start, $end) = explode('>', $value);
		
		$new_value = array();
		for ($i = $start; $i <= $end; $i++)
		{
			$new_value[] = str_pad($i, 3, '0', STR_PAD_LEFT);
		}
		
		$data = str_replace($value, implode('-', $new_value), $data);
	}
	
	return $data;
}


$zones = parse_zones("INZ021-028>031-035-036-190915-");

header('Content-type: text/plain');
var_dump($zones);

/**
 * Why do I comment out the PHP closing tag?
 * See: http://phpstarter.net/2009/01/omit-the-php-closing-tag/
 */
/* ?> */

    Putting it All Together

    So we know how to download the latest forecast data for a specific station, split it up, and get the zones for each one. Now it’s time to put it together and in a format where we can store or display it. In this example, I am adding some more basic PHP to form a large array with the forecast block and zones in each element. From there, you can easily place the data in a database or whatever.

    Note: Note that I am using data from KIND and not KLOT in this example, because KIND has forecast blocks that cover multiple zones, showing how parse_zones() work.

    Run This Example

    <?php

/**
 * adds the two functions from the previous example:
 * parse_zines()
 * parse_ranges()
 */
include('functions.php');

$data = file_get_contents('ZFPIND.txt');

/* remove the file header */
$data = trim($data);
$data = explode("\n\n", $data);
unset($data[0], $data[1]);
$data = implode("\n\n", $data);


/* separate the forecasts */
$data = explode('$$', $data);
/* trim off any extra line breaks */
$data = array_map('trim', $data);

$data_form = array();
foreach ($data as $field => $value)
{
	$lines = explode("\n", $value);
	$zones = parse_zones($lines[0]);
	
	$blocks = explode("\n\n", $value);
	$forecast = $blocks[1];
	
	$data_time = parse_date_time($value);
	
	$data_form[] = array('zones' => $zones, 'date_time' => $date_time, 'forecast' => $forecast);
}


header('Content-type: text/plain');
var_dump($data_form);


/**
 * Why do I comment out the PHP closing tag?
 * See: http://phpstarter.net/2009/01/omit-the-php-closing-tag/
 */
/* ?> */

    After running the example, you will see that we have an array with several numbered elements. Each element is a sub-array containing an array of zones and an element containing the forecast data.

    So there you have it. With one request to the NWS website, you can gather all the ZFP data for an entire forecast area. Again, this is useful when you need to gather forecasts for the general area, not just one zone at a time. If you only need to grab one zone at a time, stay tuned because I will be writing soon on how to make use of an easier data source that grabs one zone at a time that makes for easier parsing on your part.

    Making it Look Pretty

    Another teaser for a future article…Once you find the page containing the data you want to work with, it looks like an undaunted task to turn that data into something presentable. Let me assure you right off the bat that it is doable with a healthy bit of string manipulation and regular expressions. Just for a bit of comparison, you should be able to turn this into this. How do we split up the days and add the cool icons? I will cover that in the next article. To be continued…

    Related posts:

    ]]>     http://phpstarter.net/2010/03/parse-zfp-zone-forecast-product-data-in-php-option-1/feed/ 0     Merge Image Layers in PHP http://phpstarter.net/2009/07/merge-image-layers-in-php/ http://phpstarter.net/2009/07/merge-image-layers-in-php/#comments Fri, 17 Jul 2009 12:00:40 +0000 Andrew http://phpstarter.net/?p=455
  • Making Google Static Maps a Little More Dynamic with PHP
  • Parse ZFP (Zone Forecast Product) Data in PHP – Option 1
    • ]]>     In a previous article, I showed how to Locate the Nearest Radar Station and Display Radar Images. A commenter, mike, pointed out the idea of merging the image layers using PHP instead of layering all the images separately using CSS. Here is how to do it.

    Just like the previous article on finding the closest radar station, I am going to use IP geolocation to find the closest radar site. See that previous article for an explanation on how to do that.

    Run This Example

    <?php

/* replace with your own DB connection code */
require('../includes/database.php');
$db = db_connect();

/* get the IP address and make sure it is an unsigned integer */
$ip = sprintf('%u', ip2long($_SERVER['REMOTE_ADDR']));

/* fetch the location id */
$query = "SELECT locId FROM CityBlocks 
			WHERE $ip BETWEEN startIpNum AND endIpNum LIMIT 1";
$result = mysql_query($query, $db) or die(mysql_error());
$row = mysql_fetch_assoc($result);

/* now fetch the location */
$locId = $row['locId'];
$query = "SELECT * FROM CityLocation WHERE locId = $locId LIMIT 1";
$result = mysql_query($query, $db) or die(mysql_error());
$location = mysql_fetch_assoc($result);

/* offset the coordinates by 3, and find the closest station */
$lat = $location['latitude'] + 3;
$lon = $location['longitude'] - 3;
$query = "SELECT *, SQRT(POW(69.1 * (lat - $lat), 2) + 
			POW(69.1 * ($lon - lon) * COS(lat / 57.3 ), 2 )) AS distance 
			FROM RadarSites ORDER BY distance ASC LIMIT 1";
$result = mysql_query($query, $db) or die(mysql_error());
$radar = mysql_fetch_assoc($result);

/* we are using the snoopy class to download the images */
include('../includes/Snoopy.class.php');
$snoopy = new Snoopy();

/* cache the files locally */
function dl_cache($url, $filename)
{
	if (!file_exists($filename) || filemtime($filename) + 600 < time())
	{
		global $snoopy;
		$snoopy->fetch($url);
		file_put_contents($filename, $snoopy->results);
		$snoopy->results = '';
	}
}

/* download the radar images */
$radar_id = $radar['id'];
dl_cache("http://radar.weather.gov/Overlays/Topo/Short/{$radar_id}_Topo_Short.jpg", "maps/{$radar_id}_Topo_Short.jpg");
dl_cache("http://radar.weather.gov/RadarImg/N0R/{$radar_id}_N0R_0.gif", "maps/{$radar_id}_N0R_0.gif");
dl_cache("http://radar.weather.gov/Overlays/County/Short/{$radar_id}_County_Short.gif", "maps/{$radar_id}_County_Short.gif");
dl_cache("http://radar.weather.gov/Overlays/Highways/Short/{$radar_id}_Highway_Short.gif", "maps/{$radar_id}_Highway_Short.gif");
dl_cache("http://radar.weather.gov/Overlays/Rivers/Short/{$radar_id}_Rivers_Short.gif", "maps/{$radar_id}_Rivers_Short.gif");
dl_cache("http://radar.weather.gov/Overlays/Cities/Short/{$radar_id}_City_Short.gif", "maps/{$radar_id}_City_Short.gif");
dl_cache("http://radar.weather.gov/Legend/N0R/{$radar_id}_N0R_Legend_0.gif", "maps/{$radar_id}_N0R_Legend_0.gif");
dl_cache("http://radar.weather.gov/Warnings/Short/{$radar_id}_Warnings_0.gif", "maps/{$radar_id}_Warnings_0.gif");

/* load the radar layers into an array */
$layers = array();
$layers[] = imagecreatefromjpeg("maps/{$radar_id}_Topo_Short.jpg");
$layers[] = imagecreatefromgif("maps/{$radar_id}_N0R_0.gif");
$layers[] = imagecreatefromgif("maps/{$radar_id}_County_Short.gif");
$layers[] = imagecreatefromgif("maps/{$radar_id}_Highway_Short.gif");
$layers[] = imagecreatefromgif("maps/{$radar_id}_Rivers_Short.gif");
$layers[] = imagecreatefromgif("maps/{$radar_id}_City_Short.gif");
$layers[] = imagecreatefromgif("maps/{$radar_id}_N0R_Legend_0.gif");
$layers[] = imagecreatefromgif("maps/{$radar_id}_Warnings_0.gif");

$image = imagecreatetruecolor(600, 550);


/* merge the layers */
for ($i = 0; $i < count($layers); $i++)
{
	imagecopy($image, $layers[$i], 0, 0, 0, 0, 600, 550);
}

/* we're done! output the image... */
header('Content-type: image/jpeg');
imagejpeg($image);

/**
 * Why do I comment out the PHP closing tag?
 * See: http://phpstarter.net/2009/01/omit-the-php-closing-tag/
 */
/* ?> */

    The code from line ~31 on is pretty self-explanatory. Basically, I am caching the maps locally, and then loading the images into PHP image resources. I am putting the images in a PHP array because I want to make it easy add/delete/move layers. For the application I’m using it for, it’s not likely, but your needs may differ.

    The important function is imagecopy(), which is defined as:

    bool imagecopy ( resource $dst_im , resource $src_im , int $dst_x , int $dst_y , int $src_x , int $src_y , int $src_w , int $src_h )

    Since I am copying whole pictures directly on top of each other – all the same size – it’s very easy. You can specify image sizes and location in case you are copying a smaller image onto a larger image, like a logo copyright on a photo, for example.

    So there you have it. Although I believe the first method of layering the images via CSS works just fine, this method will work when you need to deliver a single image.

    Related posts:

    ]]>     http://phpstarter.net/2009/07/merge-image-layers-in-php/feed/ 2     Loading INI Files in PHP http://phpstarter.net/2009/04/loading-ini-files-in-php/ http://phpstarter.net/2009/04/loading-ini-files-in-php/#comments Tue, 14 Apr 2009 12:00:23 +0000 Andrew http://phpstarter.net/?p=424
  • Parse ZFP (Zone Forecast Product) Data in PHP – Option 1
    • ]]>     PHP parses the php.ini file for the global PHP settings, but you can create an INI file that is specific to your own PHP application. You can also load those settings into as associate array with a native PHP function. How cool is that?

    Why?

    Having your config settings in a INI file makes it easier to edit, especially for those that don’t have PHP experience. It also comes in handy if you have protected PHP scripts, and you want someone to have the option of changing settings without having access to any of the PHP code. There are a couple negative effects though. Obviously, there is going to be some performance overhead because PHP will have to parse this file for each and every request made by a site visitor. Also, you can’t assign any dynamic values here, like time(), etc. You will have to make the call to determine if this method is best for you.

    How it Works

    Below is a sample INI file that the later examples will be loading. Notice the syntax used. The double quotes are not needed, but I am in the habit of using them because they are required if any special characters are in the values.

    ;some general settings not related to anything else
[general]
home_url = "http://www.example.com/"
contact_email = "contact@example.com"
app_path = "/path/to/app/root"
name = "application name"

;settings required to connect to a MySQL database
[database]
host = "localhost"
name = "database_name"
user = "db_user"
pass = "db_password"

;show we can have an array
[arrays]
test[] = "value1"
test[] = "value2"
test[] = "value3"

    In the first load example, we are going to load all of the settings in one block. In other words, we are going to ignore the sections, defined in the ‘[ ]‘ characters.

    Run This Example

    <?php

/* load the config file and dump the values  */
$config = parse_ini_file('sample.ini');

header('Content-type: text/plain');
var_dump($config);

/**
 * Why do I comment out the PHP closing tag?
 * See: http://phpstarter.net/2009/01/omit-the-php-closing-tag/
 */
/* ?> */

    In the above example, we have a problem. Notice that we have the setting “name” in more than one block, and because of that, we had a name conflict and lost one of the values. To avoid this, we can put these setting blocks in their own associative array with the following statement.

    Run This Example

    <?php

/* load the config settings and dump the values */
$config = parse_ini_file('sample.ini', true);

header('Content-type: text/plain');
var_dump($config);

/**
 * Why do I comment out the PHP closing tag?
 * See: http://phpstarter.net/2009/01/omit-the-php-closing-tag/
 */
/* ?> */

    Now all the setting blocks are separated, and easily accessible.

    So there you have it – a different type of configuration file that may be an option for your next PHP application. It’s pretty simple, and you really only need one function call to load all the settings, so the learning curve is minimal. If you want more information on this PHP function, check out the function reference.

    Related posts:

    ]]>     http://phpstarter.net/2009/04/loading-ini-files-in-php/feed/ 0     Separating the Application & Presentation and Alternative Syntax http://phpstarter.net/2009/03/separating-the-application-presentation-and-alternative-syntax/ http://phpstarter.net/2009/03/separating-the-application-presentation-and-alternative-syntax/#comments Wed, 18 Mar 2009 16:31:47 +0000 Andrew http://phpstarter.net/?p=414
  • Merge Image Layers in PHP
  • Making Google Static Maps a Little More Dynamic with PHP
    • ]]>     One of the biggest pet peeves I have when looking at (and unfortunately – working with) other people’s PHP code is the way they integrate their code into the HTML. Many people don’t take the time to organize, and they end up with a PHP & HTML mess. I believe that it is critical to separate the application logic from the presentation. In other words – do the bulk of the application operations in a script file that has no text/HTML output. When that processing is done, send the data to the presentation file that takes the data and outputs that along with the static HTML for that page. In this article, I will present an easy way to do it using no template engines.

    I have some perfect textbook examples that I would love to post of very badly-formatted code, but because of privacy and confidentially reasons with my clients, I can’t do that. You will just have to take my word for it – I have seen some major hackjobs thrown together by the most obvious of n00bs I didn’t even know existed.

    So the main thing to remember is this: Think of your web application as having two layers – application & presentation. The only job for the presentation layer is to format the data into the HTML and send it to the browser. Everything else falls to the application layer.

    Bad Example

    I decided to write a script that would utilize a database table in my sample database. This example uses data from the article on how to Locate the Nearest Radar Station and Display Radar Images. This script will take your IP’s location, and show the 10 closest radar stations to that location – but displaying the results in way that should make you cringe.

    Run This Example

    <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
<html>
<head>
<title>IP Geolocation Example</title>
<meta name="generator" content="Bluefish 1.0.7">
<meta name="author" content="Andrew Wells">
<meta name="date" content="2008-12-26T17:05:21-0600">
<meta http-equiv="content-type" content="text/html; charset=UTF-8">
<meta http-equiv="content-type" content="application/xhtml+xml; charset=UTF-8">
</head>
<body>
<?php
/* replace with your own DB connection code */
require('../includes/database.php');
$db = db_connect();

/* get the IP address and make sure it is an unsigned integer */
$ip = sprintf('%u', ip2long($_SERVER['REMOTE_ADDR']));

/* fetch the location id */
$query = "SELECT locId FROM CityBlocks WHERE $ip BETWEEN startIpNum AND endIpNum LIMIT 1";
$result = mysql_query($query, $db) or die(mysql_error());
$row = mysql_fetch_assoc($result);

/* now fetch the location */
$locId = $row['locId'];
$query = "SELECT * FROM CityLocation WHERE locId = $locId LIMIT 1";
$result = mysql_query($query, $db) or die(mysql_error());
$location = mysql_fetch_assoc($result);

echo '<h2>Details on IP Location:</h2>';
echo '<b>Location ID:</b> ' . $location['locId'] . "<br />\n";
echo '<b>Country:</b> ' . $location['country'] . "<br />\n";
echo '<b>Region:</b> ' . $location['region'] . "<br />\n";
echo '<b>City:</b> ' . $location['city'] . "<br />\n";
echo '<b>Postal Code:</b> ' . $location['postalCode'] . "<br />\n";
echo '<b>Latitude:</b> ' . $location['latitude'] . "<br />\n";
echo '<b>Longitude:</b> ' . $location['longitude'] . "<br />\n";
echo '<b>Metro Code:</b> ' . $location['metroCode'] . "<br />\n";
echo '<b>Area Code:</b> ' . $location['areaCode'] . "<br />\n";

/* offset the coordinates by 3, and find the closest station */
$lat = $location['latitude'] + 3;
$lon = $location['longitude'] - 3;
$query = "SELECT *, SQRT(POW(69.1 * (lat - $lat), 2) + 
			POW(69.1 * ($lon - lon) * COS(lat / 57.3 ), 2 )) AS distance 
			FROM RadarSites ORDER BY distance ASC LIMIT 10";
$result = mysql_query($query, $db) or die(mysql_error());

echo'<h2>Radar Site Details</h2><table width="800">';
echo '<tr>';
echo '<th>Station ID</th>';
echo '<th>Lat</th>';
echo '<th>Lon</th>';
echo '<th>Updated</th>';
echo '<th>Distance</th>';
echo '</tr>';
for ($i = 0, $n = mysql_num_rows($result); $i < $n; $i++)
{
	$radar = mysql_fetch_assoc($result);
	echo '<tr>';
	echo '<td>' . $radar['id'] . '</td>';
	echo '<td>' . $radar['lat'] . '</td>';
	echo '<td>' . $radar['lon'] . '</td>';
	echo '<td>' . $radar['updated'] . '</td>';
	echo '<td>' . $radar['distance'] . '</td>';
	echo '</tr>';
}
echo '</table>';
?>
</body>
</html>

    This isn’t a worst cast scenario – I’ve seen worse, but I would like to point out the PHP code block in the middle of the header and footer HTML. Notice all the application work I’m doing in lines 13-67 that is right in the middle of the HTML output. Looking further, you can see that I am using echo statements to output the table HTML and other code. This is bad. It makes it hard to change the HTML without messing with the PHP, and it makes it next to impossible for a designer to work with it.

    Good Example

    Here is a better example with most of the logic separated from the HTML.

    Run This Example

    <?php
/* replace with your own DB connection code */
require('../includes/database.php');
$db = db_connect();

/* get the IP address and make sure it is an unsigned integer */
$ip = sprintf('%u', ip2long($_SERVER['REMOTE_ADDR']));

/* fetch the location id */
$query = "SELECT locId FROM CityBlocks WHERE $ip BETWEEN startIpNum AND endIpNum LIMIT 1";
$result = mysql_query($query, $db) or die(mysql_error());
$row = mysql_fetch_assoc($result);

/* now fetch the location */
$locId = $row['locId'];
$query = "SELECT * FROM CityLocation WHERE locId = $locId LIMIT 1";
$result = mysql_query($query, $db) or die(mysql_error());
$location = mysql_fetch_assoc($result);

/* offset the coordinates by 3, and find the closest station */
$lat = $location['latitude'] + 3;
$lon = $location['longitude'] - 3;
$query = "SELECT *, SQRT(POW(69.1 * (lat - $lat), 2) + 
			POW(69.1 * ($lon - lon) * COS(lat / 57.3 ), 2 )) AS distance 
			FROM RadarSites ORDER BY distance ASC LIMIT 10";
$result = mysql_query($query, $db) or die(mysql_error());

for ($i = 0, $n = mysql_num_rows($result); $i < $n; $i++)
{
	$radars[] = mysql_fetch_assoc($result);
}
?>
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
<html>
<head>
<title>IP Geolocation Example</title>
<meta name="generator" content="Bluefish 1.0.7">
<meta name="author" content="Andrew Wells">
<meta name="date" content="2008-12-26T17:05:21-0600">
<meta http-equiv="content-type" content="text/html; charset=UTF-8">
<meta http-equiv="content-type" content="application/xhtml+xml; charset=UTF-8">
</head>
<body>

<h2>Details on IP Location:</h2>
<b>Location ID:</b> <?=$location['locId']?><br />
<b>Country:</b> <?=$location['country']?><br />
<b>Region:</b> <?=$location['region']?><br />
<b>City:</b> <?=$location['city']?><br />
<b>Postal Code:</b> <?=$location['postalCode']?><br />
<b>Latitude:</b> <?=$location['latitude']?><br />
<b>Longitude:</b> <?=$location['longitude']?><br />
<b>Metro Code:</b> <?=$location['metroCode']?><br />
<b>Area Code:</b> <?=$location['areaCode']?><br />

<h2>Radar Site Details</h2><table width="800">
<tr>
	<th>Station ID</th>
	<th>Lat</th>
	<th>Lon</th>
	<th>Updated</th>
	<th>Distance</th>
</tr>
<?php foreach ($radars as $radar): ?>
<tr>
	<td><?=$radar['id']?></td>
	<td><?=$radar['lat']?></td>
	<td><?=$radar['lon']?></td>
	<td><?=$radar['updated']?></td>
	<td><?=$radar['distance']?></td>
</tr>
<?php endforeach; ?>

</table>
</body>
</html>

    In lines 46-54, I am using PHP shorthand tags to output PHP variables in a cleaner way. The other thing you will notice is that there is no getting around the loop structure that is needed to output the 10 radar sites. We can do it without the curly braces though, and with neater “tags” in the HTML to control the loop.

    Another thing to mention – I would even have the PHP block in a different file, but I combined them for the simplicity of the example.

    PHP Shorthand Tags and Alternative Syntax

    Since the presentation files are to be more focused on the HTML, and won’t be very PHP-intense, we can use simplified tags. To output PHP variables in HTML without the PHP opening/closing tags, we use the shorthand method:

    <!-- old method -->
<html>
<?php
    echo $some_var;
?>
</html>

<!-- better method -->
<html>
<?=$some_var?>
</html>

    If we need to have a control structure, such as an if statement or loop, we do it this way:

    <html>
<?php if ($condition): ?>
<p>Some content here</p>
<?php endif; ?>
</html>

    Here is a loop example:

    <html>
<?php for ($i = 0; $i < 10; $i++): ?>
<p>Some content here with the current index of <?=$i?></p>
<?php endfor; ?>
</html>

    So there you have it – a few tips for you to create more readable code. I have read that doing it this way with several PHP opening/closing tags can hurt performance by a hair, but I prefer losing a few CPU cycles over several hours debugging later down the road. The choice is yours. :)

    Related posts:

    ]]>     http://phpstarter.net/2009/03/separating-the-application-presentation-and-alternative-syntax/feed/ 0     Working with AJAX http://phpstarter.net/2009/03/working-with-ajax/ http://phpstarter.net/2009/03/working-with-ajax/#comments Thu, 05 Mar 2009 06:00:24 +0000 Kurtis http://phpstarter.net/?p=409 AJAX is all over the internet today, and though completely unnecessary, a website with it can function much more quickly. Data can be transferred to and from users efficiently, but a major drawback is the extra code needed and some security issues inherent. Nevertheless, for certain applications, AJAX is great to know and take your project to a new level.The truth is that tutorials for learning the basics of AJAX are all over the internet.  For the quick setup of JavaScript, check out any of these.  What I want to focus on are more practical applications of the PHP end of AJAX.  Surely you can understand the basics of passing variables to a PHP processing page, but let’s go over a few examples to understand what AJAX can accomplish for us.
    First of all, a soon-to-come feature on JeoReview is on the page where boards can be created.  The issue is that there is a chance that someone will pick a board name that is already in use, and while the PHP is set up to catch the error, I would like for JavaScript to be able to handle it earlier and more quickly to prevent posting to pages over and over again.  So we will set up the JavaScript much like the examples show:

    var xmlHttp;

function checkName(name) {
var url="checkName.php";
url=url+"?n="+name;
xmlHttp.onreadystatechange=stateChanged;
xmlHttp.open("GET",url,true);
xmlHttp.send(null);
}

function stateChanged()
{
if (xmlHttp.readyState==4 || xmlHttp.readyState=="complete")
{
document.getElementById("nStatus").innerHTML=xmlHttp.responseText;
}
}
function GetXmlHttpObject()
{
var xmlHttp=null;
try
{
// Firefox, Opera 8.0+, Safari
xmlHttp=new XMLHttpRequest();
}
catch (e)
{
// Internet Explorer
try
{
xmlHttp=new ActiveXObject("Msxml2.XMLHTTP");
}
catch (e)
{
xmlHttp=new ActiveXObject("Microsoft.XMLHTTP");
}
}

return xmlHttp;
}

    I would place this into a separate JavaScript file and link it to the page where the action takes place, but all that is really needed from this point is to add an event trigger to the form field to execute this function.  Something like this:

    
...

<input type='text' value='' onchange='checkName(this.value);' />

<p id='nStatus'>Please enter a name for your board.</p>

...

    You can see then that the value from the form field will be checked in the function which will send the data to a PHP file which we must now define.  Whatever that PHP file “responds” with (or echoes back) will be displayed in the ‘p’ tag we defined below the input field.  So let’s finish it off with the PHP file which must check the name entered against the boards already existing in the MySQL database, leading to something like this:

    
<?php

//Connect to MySQL...

$name = mysql_real_escape_string($_GET['n']);

//We're using the GET method here, but there are applications of POST

$getBoards = mysql_query("SELECT `id` FROM `boards` WHERE `name`='$name'");

if (mysql_num_rows($getBoards) == 0) { echo "OK"; }

else { echo "Taken"; }

?>

    Depending on your application, the echoed strings would be changed and perhaps even a bit more complex, but these work fine for the basic application we worked through.

    As I noted above, we used the GET method, just like what is used in normal forms, where variables are passed through the URL to be accessed by the PHP file.  However, POST can be used and should be used in certain situations.  In general, they coincide with the general rules for form method choosing.  GET should be used for shorter requests of one or two variables and POST for multiple fields and especially those sent to the database.  Remember that the URL from GET can only be so long before cut off and may not be able to hold all the information from a long request.  Therefore, POST is certainly the most viable choice because it can be used in all applications by simply altering the method in the JavaScript and PHP and adding a few lines as noted on the tutorials listed above.

    Still wondering where AJAX can come in handy?  We’ve all seen those handy “username checks” on registration pages and the suggestions provided by Google, Yahoo!, YouTube, and other big-name websites, and these all employ AJAX.   Whether you realized it or not because of their speed, these pages actually utilize more code than a typical PHP/ASP check, but they have certain disadvantages and will always be up for debate.

    No related posts.

    ]]>     http://phpstarter.net/2009/03/working-with-ajax/feed/ 2     More Examples with Parsing NDFD Data in PHP http://phpstarter.net/2009/03/more-examples-with-parsing-ndfd-data-in-php/ http://phpstarter.net/2009/03/more-examples-with-parsing-ndfd-data-in-php/#comments Tue, 03 Mar 2009 11:00:10 +0000 Andrew http://phpstarter.net/?p=396
  • Merge Image Layers in PHP
    • ]]>     I covered how to Parse Weather Forecast Data (from the NDFD) in PHP in a previous article, but due to the amount of questions I received, I decided to show some more usage techniques and examples. In this article, I will cover the time-series option as well as some methods on how to make some data more presentable.

    Fetching Time-Series Data from the NDFD

    This was covered as an appendix in the previous article, but I will include it here as well in case you are only reading it in the feeds or by email.

    Requesting the time-series data returns a whole bunch more information. As requested, here is an example on how to fetch it. Change the desired parameters to ‘true’. The other examples on how to parse the time layouts and formatting data works on this XML, too.

    Run This Example

    <?php

/* http://sourceforge.net/projects/nusoap/ */
require('../includes/nusoap/nusoap.php');

$parameters = array('product'	=> 'time-series',
					'latitude'  => 41.879535,
					'longitude'	=> -87.624333,
					'weatherParameters' => array(
					
	'maxt' => true,			'mint' => false,		'temp' => false,			'dew' => false,	
	'appt' => true,			'pop12' => false,		'qpf' => false,				'snow' => false,	
	'sky' => false,			'rh' => false,			'wspd' => false,			'wdir' => false,	
	'wx' => false,			'icons' => false,		'waveh' => false,			'incw34' => false,	
	'incw50' => false,		'incw64' => false,		'cumw34' => false,			'cumw50' => false,	
	'cumw64' => false,		'wgust' => false,		'conhazo' => false,			'ptornado' => false,	
	'phail' => false,		'ptstmwinds' => false,	'pxtornado' => false,		'pxhail' => false,	
	'pxtstmwinds' => false,	'ptotsvrtstm' => false,	'pxtotsvrtstm' => false,	'tmpabv14d' => false,	
	'tmpblw14d' => false,	'tmpabv30d' => false,	'tmpblw30d' => false,		'tmpabv90d' => false,	
	'tmpblw90d' => false,	'prcpabv14d' => false,	'prcpblw14d' => false,		'prcpabv30d' => false,	
	'prcpblw30d' => false,	'prcpabv90d' => false,	'prcpblw90d' => false,		'precipa_r' => false,	
	'sky_r' => false,		'td_r' => false,		'temp_r' => false,			'wdir_r' => false,	
	'wwa' => false,			'wspd_r' => false)
	
					);

try
{
	/* create the nuSOAP object */
	$c = new nusoap_client('http://www.weather.gov/forecasts/xml/DWMLgen/wsdl/ndfdXML.wsdl', 'wsdl');
	
	/* make the request */
	$result = $c->call('NDFDgen', $parameters);
}
catch (Exception $ex)
{
	/* nuSOAP throws an exception is there was a problem fetching the data */
	echo 'failed';
}

header('Content-type: text/xml');
echo $result;

/* ?> */

    Merging Sets of Data with Different Time Layouts

    The different sets of data in the NDFD are most likely going to be wanted to be displayed together. For example, on this page, you will see that I have the conditions icons, max temps, and min temps all showing at the same time intervals. But how is that possible?

    In this example case, we are going to match up the high temperatures with their conditions icon. This may not give an accurate weather condition for the day because we are going to pick the icon that is the closest to the time stamp given for that temperature. In other words, the condition icons are for every hour or so, and the temperatures are only twice a day. We have to pick two of those icons to match up with the two temperatures. So for example, if the forecast for the day is “sunny in the morning, then t’storms in the afternoon”, the icon will show up as sunny.

    Run This Example

    <?php

/* returns the next element based on the key provided */
function array_next($array, $key, $offset = 0)
{
	/* if the key exists, we're done */
	if (isset($array[$key]) && $offset == 0) return $array[$key];
	
	/* insert the key into the array and sort it */
	$array[$key] = 1;
	ksort($array);
	
	/* now get the array in order */
	$keys = array_keys($array);
	
	/* find where our inserted key is and get the next element */
	$index = array_search($key, $keys);
	if ($offset == 0) $offset = 1;
	$index += $offset;
	return (isset($keys[$index])) ? $array[$keys[$index]] : FALSE;
}

/**
 * load the forecast data array as produced in the below example:
 * http://phpstarter.net/samples/348/parse_data.php
 * More information:
 * http://phpstarter.net/2009/02/parse-weather-forecast-data-from-the-ndfd-in-php/
 */
include('parse_data.php');
$forecast = parse_data();

?>
<html>
<head><title>NDFD Usage Example w/ Different Time Layouts</title></head>
<body>
<h1>Show High Temps with Icons</h1>
<?php foreach ($forecast['max_temps'] as $timestamp => $temp): ?>
<p><?=$field?><br />
<img src="<?=array_next($forecast['icons'], $timestamp)?>" /><br />
High: <?=$temp?></p>
<?php endforeach; ?>
</body>
</html>

    In the above example, the array_next() function is the one that allows us to match up the data arrays. The first parameter is the array of the weather data that we are trying to find…or in our case, the conditions icon. The second parameter is the key that we want to get close to…or in our case, the timestamp for the temperature we are displaying. So, we loop through the temperatures and search for the closest icon for each one.

    Collecting and Using the Time Labels

    Depending on that kind of data you are requesting, some of the time layouts contain the time labels. I had those time labels displayed in a data array called time_labels in a previous example, but I didn’t explain how I did it. Basically, I wrote a function that sifts through all of the time layouts. If it finds one with a “period-name” attribute, it saves that timestamp and the period name in a data array similar to the other data items (temp, conditions, etc).

    Run This Example

    <?php

/**
 * get the time layouts in an array form
 * 
 * @param string $xml
 * @return mixed
 */
function get_time_labels($xml)
{
	$data = $xml->xpath("//start-valid-time");
	$times = array();
	
	foreach ($data as $field => $value)
	{
		if ((string)$value['period-name'])
		{
			$index = (string)$value;
			$times[$index] = (string)$value['period-name'];
		}
	}
	
	ksort($times);
	
	return $times;
}

/* working with stale data, but why query for it every time */
$xml = file_get_contents('ndfd_forecast.xml');
$xml = new SimpleXMLElement($xml);

$time_labels = get_time_labels($xml);

header('Content-type: text/plain');
var_dump($time_labels);

/**
 * Why do I comment out the PHP closing tag?
 * See: http://phpstarter.net/2009/01/omit-the-php-closing-tag/
 */
/* ?> */

    We can apply it with the Merging Sets of Data example, and end up with something like this:

    Run This Example

    <?php

/* returns the next element based on the key provided */
function array_next($array, $key, $offset = 0)
{
	/* if the key exists, we're done */
	if (isset($array[$key]) && $offset == 0) return $array[$key];
	
	/* insert the key into the array and sort it */
	$array[$key] = 1;
	ksort($array);
	
	/* now get the array in order */
	$keys = array_keys($array);
	
	/* find where our inserted key is and get the next element */
	$index = array_search($key, $keys);
	if ($offset == 0) $offset = 1;
	$index += $offset;
	return (isset($keys[$index])) ? $array[$keys[$index]] : FALSE;
}

/**
 * load the forecast data array as produced in the below example:
 * http://phpstarter.net/samples/348/parse_data.php
 * More information:
 * http://phpstarter.net/2009/02/parse-weather-forecast-data-from-the-ndfd-in-php/
 */
include('parse_data.php');
$forecast = parse_data();

?>
<html>
<head><title>Show Condition Icons with Time Labels</title></head>
<body>
<h1>Show Condition Icons with Time Labels</h1>
<?php foreach ($forecast['time_labels'] as $timestamp => $label): ?>
<p><?=$label?><br />
<img src="<?=array_next($forecast['icons'], $timestamp)?>" /></p>
<?php endforeach; ?>
</body>
</html>

    So there you have it – more possible applications and examples with this abundant weather forecast data. As with all other advanced articles on phpstarter.net, this is not intended provide you with copy-and-paste code to paste right in your web applications with little or no modifications. You really need to understand how this all works, and adapt it as necessary or rewrite the examples completely based on what you learned here and what you need to use it for. The point is to get you to understand the concepts used here so you can apply them to your web applications. Happy coding! :)

    Related posts:

    ]]>     http://phpstarter.net/2009/03/more-examples-with-parsing-ndfd-data-in-php/feed/ 14     Parse Current Weather Conditions Data from the NWS in PHP http://phpstarter.net/2009/02/parse-current-weather-conditions-data-from-the-nws-in-php/ http://phpstarter.net/2009/02/parse-current-weather-conditions-data-from-the-nws-in-php/#comments Thu, 26 Feb 2009 12:00:36 +0000 Andrew http://phpstarter.net/?p=386
  • Merge Image Layers in PHP
    • ]]>     In a previous article, I covered 5 Sources of Free Weather Data for your Site, but did not provide any actual code to use the data. Last week, I covered source #1 and showed how to Parse Weather Forecast Data (from the NDFD) in PHP. For this article, I will show how to parse source #2 – the current weather conditions data as provided by the National Weather Service.

    Fetching the Data for One Station at a Time

    This is ideal for a website that wants to show the current conditions for one location. Go to the XML Feeds page, and find your station. We need to know the station id for your area, so select your state, and then find the closest station to you.

    The example below shows how easy it is to fetch the XML and format it into something we can read.

    <?php

/**
 * Download a copy here:
 * http://sourceforge.net/projects/snoopy/
 */
require('../includes/Snoopy.class.php');

/**
 * Load a single station and return the data
 */
function load_single_station($station_id, &$xml)
{
	$snoopy= new Snoopy();
	$snoopy->fetch('http://www.weather.gov/xml/current_obs/' . $station_id . '.xml', $xml_tmp . $station_id . '.xml');
	
	if (!$snoopy->results)
	{
		/* oops */
		return false;
	}
	
	$data = $snoopy->results;
	
	try
	{
		/* convert the XML into a data object */
		$xml = @new SimpleXMLElement($data);
		/* convert that data object into an array, and return it */
		return get_object_vars($xml);
	}
	catch (Exception $e)
	{
		/* we got an empty or invalid XML file */
		return false;
	}
}

$conditions = load_single_station('KLOT', $xml);
var_dump($conditions);

/**
 * Why do I comment out the PHP closing tag?
 * See: http://phpstarter.net/2009/01/omit-the-php-closing-tag/
 */
/* ?> */

    Although that example gets the job done, we are going to want to do some caching. It’s a bit pointless to be fetching that XML file every time a page is requested. With a little bit of database code, we can make it relatively easy. First, setup a database that your script has access to, and create this table:

    CREATE TABLE `Current` (
  `suggested_pickup` varchar(55) NOT NULL,
  `last_update` timestamp NOT NULL default CURRENT_TIMESTAMP on update CURRENT_TIMESTAMP,
  `suggested_pickup_period` smallint(6) NOT NULL,
  `location` varchar(55) NOT NULL,
  `station_id` varchar(10) NOT NULL,
  `latitude` decimal(5,2) NOT NULL,
  `longitude` decimal(5,2) NOT NULL,
  `observation_time` varchar(255) NOT NULL,
  `observation_time_rfc822` varchar(255) NOT NULL,
  `weather` varchar(55) NOT NULL,
  `temperature_string` varchar(55) NOT NULL,
  `temp_f` smallint(6) NOT NULL,
  `temp_c` smallint(6) NOT NULL,
  `relative_humidity` tinyint(4) NOT NULL,
  `wind_string` varchar(55) NOT NULL,
  `wind_dir` varchar(55) NOT NULL,
  `wind_degrees` smallint(6) NOT NULL,
  `wind_mph` smallint(6) NOT NULL,
  `wind_gust_mph` smallint(6) NOT NULL,
  `pressure_string` varchar(55) NOT NULL,
  `pressure_mb` smallint(6) NOT NULL,
  `pressure_in` decimal(5,2) NOT NULL,
  `dewpoint_string` varchar(55) NOT NULL,
  `dewpoint_f` smallint(6) NOT NULL,
  `dewpoint_c` smallint(6) NOT NULL,
  `heat_index_string` varchar(55) NOT NULL,
  `heat_index_f` smallint(6) NOT NULL,
  `heat_index_c` smallint(6) NOT NULL,
  `windchill_string` varchar(55) NOT NULL,
  `windchill_f` smallint(6) NOT NULL,
  `windchill_c` smallint(6) NOT NULL,
  `visibility_mi` decimal(5,2) NOT NULL,
  `icon_url_base` varchar(255) NOT NULL,
  `icon_url_name` varchar(55) NOT NULL,
  `two_day_history_url` varchar(255) NOT NULL,
  `ob_url` varchar(255) NOT NULL,
  PRIMARY KEY  (`station_id`),
  KEY `latitude` (`latitude`,`longitude`)
) ENGINE=MyISAM DEFAULT CHARSET=latin1;

    After that MySQL table is created, have a look at this next example. It’s the same as the last one, but with two new functions: load_single_station_cache() & save_conditions(). The load_single_station_cache() function checks the table for a non-stale record for the specified station. If it finds one, it returns that database record, and no XML file is downloaded. If it doesn’t find one, it calls up load_single_station(), just like the first example, and then saves that data with the save_conditions() function.

    Run This Example

    <?php

/**
 * Download a copy here:
 * http://sourceforge.net/projects/snoopy/
 */
require('../includes/Snoopy.class.php');

/**
 * replace with your database connection code
 */
require('../includes/database.php');
db_connect();

/**
 * Load a single station and return the data
 */
function load_single_station($station_id, &$xml)
{
	$snoopy= new Snoopy();
	$snoopy->fetch('http://www.weather.gov/xml/current_obs/' . $station_id . '.xml', $xml_tmp . $station_id . '.xml');
	
	if (!$snoopy->results)
	{
		/* oops */
		return false;
	}
	
	$data = $snoopy->results;
	
	try
	{
		/* convert the XML into a data object */
		$xml = @new SimpleXMLElement($data);
		/* convert that data object into an array, and return it */
		return get_object_vars($xml);
	}
	catch (Exception $e)
	{
		/* we got an empty or invalid XML file */
		return false;
	}
}

/**
 * Save the weather conditions to the database table.
 */
function save_conditions($conditions)
{
	/**
	 * Get the columns and interect that list with the data array, 
	 * so we don't try to insert some fields that don't exist
	 */
	$query = "SHOW COLUMNS FROM Current";
	$result = mysql_query($query);
	$fields = array();
	
	for ($i = 0, $n = mysql_num_rows($result); $i < $n; $i++)
	{
		$row = mysql_fetch_row($result);
		$fields[] = $row[0];
	}
	$fields = array_flip($fields);
	$conditions = array_intersect_key($conditions, $fields);
	
	/**
	 * Form the data pairs into query format.
	 * Uncomment the echo statement below to see what it's doing.
	 */
	$fields = $values = '';
	foreach ($conditions as $field => $value)
	{
		$fields .= $field . ",";
		$values .= "'" . mysql_real_escape_string($value) . "',";
	}

	/* remove the last comma from both variables */
	$fields = substr($fields, 0, strlen($fields) - 1);
	$values = substr($values, 0, strlen($values) - 1);
	
	$query = "DELETE FROM Current WHERE station_id = '{$conditions['station_id']}' LIMIT 1";
	mysql_query($query);
	$query = "INSERT INTO Current ($fields) VALUES ($values)";
	//echo $query;
	$result = mysql_query($query);
	if (!$result) die(mysql_error());
}

/**
 * Load the weather conditions from the DB table, and make the necessary 
 * calls if a recent record does not exist.
 */
function load_single_station_cache($station_id, &$xml)
{
	$station_id_esc = mysql_real_escape_string($station_id);
	
	/* no results will be returned if there is no record, *or* if 
		the record is more than 5400 seconds (90 minutes) old */
	$query = "SELECT * FROM Current WHERE station_id = '$station_id_esc' && last_update + 5400 > NOW() LIMIT 1";
	$result = mysql_query($query);
	if (!$result) die(mysql_error());
	
	if (mysql_num_rows($result) == 0)
	{
		/* load a fresh set of conditions */
		$conditions = load_single_station($station_id, &$xml);
		
		/* don't forget to save it for later */
		save_conditions($conditions);
		
		return $conditions;
	}
	else
	{
		/* we got it */
		return mysql_fetch_assoc($result);
	}
}

$conditions = load_single_station_cache('KLOT', $xml);
header('Content-type: text/plain');
var_dump($conditions);

/**
 * Why do I comment out the PHP closing tag?
 * See: http://phpstarter.net/2009/01/omit-the-php-closing-tag/
 */
/* ?> */

    Fetching the Data for all Stations

    Higher traffic sites that show conditions for all or most of the available stations may want to download all of the stations at once from their data feeds page, and import them into a database. To do this, we are going to need to download the zip file from the website, and then extract it. I am not going to provide specific code, because it’s unique to the server environment. Binary files can be downloaded via cURL or fsockopen() as an alternative. Once downloaded, use PHP’s Zip functions to extract the files to a temp directory. Zlib is required to open a zip archive in PHP, so if you don’t have it, you can use the shell_exec() function to run the necessary unzip functions in the shell, assuming that your server supports it.

    Once you have the XML files at your disposal, use something like the scandir() function and import all files using something like the single-station example.

    So there you have it – XML files turned into an easy to manage, cache-able associative array.

    If these examples were enough to make your head spin, there are easy alternatives to show current conditions on your website. Check out these free weather stickers that are easier to use, although not as customizable.

    Related posts:

    ]]>     http://phpstarter.net/2009/02/parse-current-weather-conditions-data-from-the-nws-in-php/feed/ 3     Regular Expressions May Cause Irregularity http://phpstarter.net/2009/02/regular-expressions-may-cause-irregularity/ http://phpstarter.net/2009/02/regular-expressions-may-cause-irregularity/#comments Tue, 24 Feb 2009 06:00:14 +0000 Kurtis http://phpstarter.net/?p=379
  • Loading INI Files in PHP
    • ]]>     Regular expressions seem rather complex, even like a foreign language to beginning programmers.  The mixture of symbols and characters can bring you to tears if you have a limited understanding, but with the knowledge of the significance of each symbol and construct, regular expressions can bring you from irregularity to peaceful contention bliss.A regular expression (regex for short) is a pattern describing a string of text.  There are levels of complexity for regular expressions, from simple strings of literal characters to repetition and grouping.

    The most basic regular expression consists of a single literal character like a.  It will match that character in a string, but only on the first time, unless you apply repetitive properties to it or are more specific.  To use literal symbols, [, \, ^, $, ., |, ?, *, (, ) you must escape them with a backslash (\).   For example, 1\+1=2 is the correct regular expression to match 1+1=2.

    Next are character classes or character sets.  Instead of specifying each letter of the alphabet or digit, it is possible instead to use sets of alphanumeric characters to match a string.  For instance six[a-z]+ matches sixteen, sixty, and sixlet, among others.  Charcter sets should be placed within brackets and can include any range of lower-case characters, upper-case characters, digits from 0 to 9, hyphens, and underscores.

    Regular expressions do have some shorthand character classes to ease your mind:  \d for all digits, \w for all alphanumeric characters or the underscore (“_”), \s for whitespace characters including tabs and line breaks, \t for tabs individually, \r for carriage returns, and \n for line feeds.  Remember that Windows text files use \r\n to terminate lines while UNIX text files simply use \n.

    The dot or period (“.”) stands for any character except line break characters, meaning the same as [^\n], where the ^ character means the negation of the following character (“anything but …”).  Often times a character class or negated character class is faster and more precise, so be cautious when using the dot.

    Alternation allows for some choice in your regular expressions.  Using the vertical pipe bar (“|”), you can make sixteen, sixty, and sixlet all match the following regular expression: six(teen|ty|let).  The question mark (“?”) allows for optional characters, for instance when dealing with British-English and American-English spellings (colou?r matches color and colour).

    Lastly is the issue of repetition.  The asterisk (“*”) tells the engine to atempt to match the class zero or more times.  The plus sign (“+”) tries to match one or more times.  An integer in curly brackets following a class can specify an exact amount of instances.

    Now for some examples.  The description above can seem quite weighty and boring, but some applications should solidify the ideas and clarify any confusion.

    Format of an e-mail address

    
<?php

$goodEmail = "yourname@yourdomain.com";

$badEmail = "thisIsNoEmailAtAll";

$niceTry = "thisIsClose@domain";

$tooManyAts = "thisIsCloseToo@@domain";

if (@preg_match('/[-a-zA-Z0-9]+@{1}[-a-zA-Z0-9]+[\.]{1}[a-zA-Z]{2,4}[\.]*[-a-zA-Z0-9]*/', $email)) {

echo "Good email!";

}

else {

echo "The format of your e-mail address is unacceptable.";

}

?>

    You can run through each e-mail address above, and the one named as good will work while the others will fail.  Notice that we allow for three or four letter domains as well as those like “co.uk” where the domain would have two periods (“.”).

    Another common use of regular expressions is in URL rewriting.  For instance, on my website, JeoReview, when a user access a URL like ‘http://www.jeoreview.com/board/Board-Name’ a different page is served to show the board itself.  In truth, that URL does not exist.  The regular expression, as placed in the .htaccess file, looks like this:

    
Options FollowSymLinks
RewriteEngine On
RewriteRule ^board/(.+)$ loadboard.php?name=$1

    The caret (“^”) marks the beginning of the string and the dollar sign (“$”) marks the end.  Because nearly any character can be used for the board name, a dot (“.”) is used to match the name itself.  In truth, the better alternative would be to match exactly what characters can be used to increase speed and accuracy.  In any case, the $1 refers to the first character case, and each subsequent integer is filled with the following character cases, though in this example there is only one.

    There are plenty of other great uses of regular expressions.  Check some out by visiting these great resources and cheat sheets:

    Related posts:

    ]]>     http://phpstarter.net/2009/02/regular-expressions-may-cause-irregularity/feed/ 0     Parse Weather Forecast Data (from the NDFD) in PHP http://phpstarter.net/2009/02/parse-weather-forecast-data-from-the-ndfd-in-php/ http://phpstarter.net/2009/02/parse-weather-forecast-data-from-the-ndfd-in-php/#comments Thu, 19 Feb 2009 12:00:44 +0000 Andrew http://phpstarter.net/?p=348 In a previous article, I covered 5 Sources of Free Weather Data for your Site, but did not provide any actual code to use the data. Starting with this article, I will post instructions on how to handle this data as well as sample code. For this article, we will start with the National Digital Forecast Database (NDFD) Simple Object Access Protocol (SOAP) Web Service.

    Where to Find the Data

    See weather.gov/xml for full details and available data. We will be using the 24 Hourly format, which gives us temperatures, cloud cover %, weather type (rain, snow, etc), hazardous conditions, and even weather icons.

    Code to Fetch the Data

    Below is some sample code that will fetch the data. The lat/lon coordinates need to be changed for your desired location on lines 10-11. Currently, it is set for Chicago, IL.

    <?php

/* http://sourceforge.net/projects/nusoap/ */
require('../includes/nusoap/nusoap.php');

$parameters = array('product'	=> 'glance',
					'numDays'   => 5,
					'format'    => '24 hourly',
					'latitude'  => 41.879535,
					'longitude'	=> -87.624333);

try
{
	/* create the nuSOAP object */
	$c = new nusoap_client('http://www.weather.gov/forecasts/xml/DWMLgen/wsdl/ndfdXML.wsdl', 'wsdl');
	
	/* make the request */
	$result = $c->call('NDFDgen', $parameters);
}
catch (Exception $ex)
{
	/* nuSOAP throws an exception is there was a problem fetching the data */
	echo 'failed';
}

header('Content-type: text/xml');
echo $result;

/* ?> */

    This is by no means a production sample. You are going to want to cache the results somehow so you aren’t querying the NDFD every time you need this information. It is only updated every hour at most, so there is no need to query it more frequent than that.

    Understanding the XML Output

    It took me a great deal of staring and reading to figure out how this XML output is organized. Have a look at this sample output, as I will refer to this specific example to explain the sections. I recommend loading the sample XML file in Firefox or any other web browser that allows you to collapse and expand the XML tree.

    First, collapse the “head” area by clicking on the minus next to the “head” tag. Everything in there is pretty self-explanatory. Our focus is going to be in the “data” tag. Next, collapse all tags inside the “data” tag, except for the “parameters” tag, but collapse everything inside the “parameters” tag so we can see everything in there w/o scrolling. Here is what your view should look like:

    ndfd_01

    Now we are at a point where we can see how this is all grouped together. As we can see, the “parameters” section shows the products that are available, which are temperature (minimum), temperature (maximum), cloud-amount, weather, conditions-icon, and hazards. Each of them is associated with a time layout because most products are on a different time scale. For example, max temps are during the afternoon & once a day, min temps are at night & once a day, the conditions icons are at several points throughout the next several days, etc. It is separated out this way because not all products have a different time scale – some are the same, like “weather” and “conditions-icon” in our example.

    Time to match each product to their time layout. We see that the maximum temps have the time layout of “k-p24h-n7-1″, so we go up to the time layouts and find one with the layout-key of “k-p24h-n7-1″.

    ndfd_02

    We have to code a way to merge all data sets with their corresponding time layout. This may look complicated, but I will show you a somewhat easy way to parse this in PHP.

    Run This Example

    <?php
/************************************/
/* some functions we will use later */
/************************************/

/**
 * get the string values of the object items
 * @param mixed $object the XML object to extract the string values from
 * @return array
 */
function get_values($object)
{
	$arr = array();
	foreach ($object as $field => $value)
	{
		$arr[] = (string)$value;
	}
	
	return $arr;
}

/*****************************/
/* actual script starts here */
/*****************************/

/* load our example from http://phpstarter.net/samples/348/ndfd_forecast.xml */
$xml_data = file_get_contents('ndfd_forecast.xml');

/* parse the XML data into a giant data object */
try
{
	$xml = new SimpleXMLElement($xml_data);
}
catch (Exception $ex)
{
	/* the XML was probably invalid */
	die('Failed to parse the XML');
}

/* all time layouts go in here with the layout-key as the array keys */
$times = array();

/* loop through the time-layouts in the XML */
foreach ($xml->xpath('//time-layout') as $field => $value)
{
	/* get the layout-key to make it the array key value */
	$layout = (string)$value->{'layout-key'};
	
	
	$times[$layout] = array('start' => get_values($value->xpath('start-valid-time')), 
							'end' => get_values($value->xpath('end-valid-time')));
}

header('Content-type: text/plain');
var_dump($times);


/**
 * Why do I comment out the PHP closing tag?
 * See: http://phpstarter.net/2009/01/omit-the-php-closing-tag/
 */
/* ?> */

    Now we have all the time layouts in a way we can manage it. The next task is to match it up to the data to their respective time layouts. This next example includes the code to organize the time layouts, and then organize the data to correspond with the times. Running the example below will show that the data is now neatly organized in a way that it can be easily used.

    Run This Example

    <?php
/************************************/
/* some functions we will use later */
/************************************/

/**
 * get the string values of the object items
 * @param mixed $object the XML object to extract the string values from
 * @return array
 */
function get_values($object)
{
	$arr = array();
	foreach ($object as $field => $value)
	{
		$arr[] = (string)$value;
	}
	
	return $arr;
}

/**
 * Combine a time layout with a product
 * 
 * @param string $data_xpath the xpath to the data set
 * @param string $time_xpath the xpath to the time layout
 * @param array $times the big assoc array of all the time layouts
 */
function merge_times_data($data_xpath, $time_xpath, $times, $xml)
{
	$data = get_values($xml->xpath($data_xpath));
	$time_layout = $xml->xpath($time_xpath);
	if (!$time_layout) return false;
	$time_layout = (string)$time_layout[0]['time-layout'];
	$data = array_combine($times[$time_layout]['start'], $data);
	
	return $data;
}

/**
 * get the time layouts in an array form
 * 
 * @param string $xml
 * @return mixed
 */
function get_time_labels($xml)
{
	$data = $xml->xpath("//start-valid-time");
	$times = array();
	
	foreach ($data as $field => $value)
	{
		if ((string)$value['period-name'])
		{
			$index = (string)$value;
			$times[$index] = (string)$value['period-name'];
		}
	}
	
	ksort($times);
	
	return $times;
}

/*****************************/
/* actual script starts here */
/*****************************/

/* load our example from http://phpstarter.net/samples/348/ndfd_forecast.xml */
$xml_data = file_get_contents('ndfd_forecast.xml');

/* parse the XML data into a giant data object */
try
{
	$xml = new SimpleXMLElement($xml_data);
}
catch (Exception $ex)
{
	/* the XML was probably invalid */
	die('Failed to parse the XML');
}

/* all time layouts go in here with the layout-key as the array keys */
$times = array();

/* loop through the time-layouts */
foreach ($xml->xpath('//time-layout') as $field => $value)
{
	/* get the layout-key to make it the array key value */
	$layout = (string)$value->{'layout-key'};
	
	
	$times[$layout] = array('start' => get_values($value->xpath('start-valid-time')), 
							'end' => get_values($value->xpath('end-valid-time')));
}

$forecast['max_temps'] = merge_times_data("//parameters/temperature[@type='maximum']/value", 
	"//parameters/temperature[@type='maximum']", $times, $xml);
$forecast['min_temps'] = merge_times_data("//parameters/temperature[@type='minimum']/value", 
	"//parameters/temperature[@type='minimum']", $times, $xml);
$forecast['temps'] = array_merge($forecast['min_temps'], $forecast['max_temps']);
$forecast['icons'] = merge_times_data("//parameters/conditions-icon/icon-link", 
	"//parameters/conditions-icon", $times, $xml);
$forecast['time_labels'] = get_time_labels($xml);

header('Content-type: text/plain');
var_dump($forecast);

/**
 * Why do I comment out the PHP closing tag?
 * See: http://phpstarter.net/2009/01/omit-the-php-closing-tag/
 */
/* ?> */

    There is another function in that example that associates the times to the time labels that you see in the XML. Some of them has a parameter called “period-name”, which is the day of the week or holiday name, if applicable.

    How to Use the Formatted Data

    For this last example, I will show you in the simplest terms how to use this data. Remember, we are not pulling data from the NDFD live – this is using the XML from our earlier example, so the temps are for mid-winter in NW Indiana.

    Run This Example

    <?php

/**
 * pick up where we left off from the last example
 * no need to generate the data array again here
 */
$forecast = file_get_contents('data.txt');
$forecast = unserialize($forecast);

/**
 * Show the temperatures
 */

foreach ($forecast['max_temps'] as $field => $value)
{
	echo 'High temp for ' . $forecast['time_labels'][$field] . ': ' . $value . "<br />\n";
}

foreach ($forecast['min_temps'] as $field => $value)
{
	echo 'Low temp for ' . $forecast['time_labels'][$field] . ': ' . $value . "<br />\n";
}

/**
 * Why do I comment out the PHP closing tag?
 * See: http://phpstarter.net/2009/01/omit-the-php-closing-tag/
 */
/* ?> */

    So there you have it – an XML parsing nightmare made easy. This method is in my opinion the best way to receive and parse this data from the National Weather Service. It may not be the best way for everyone, so if you have something better to add, please post a comment!

    (Added 2009/02/20) Fetching Time-Series Data from the NDFD

    Requesting the time-series data returns a whole bunch more information. As requested, here is an example on how to fetch it. Change the desired parameters to ‘true’. The other examples on how to parse the time layouts and formatting data works on this XML, too.

    <?php

/* http://sourceforge.net/projects/nusoap/ */
require('../includes/nusoap/nusoap.php');

$parameters = array('product'	=> 'time-series',
					'latitude'  => 41.879535,
					'longitude'	=> -87.624333,
					'weatherParameters' => array(
					
	'maxt' => true,			'mint' => false,		'temp' => false,			'dew' => false,	
	'appt' => true,			'pop12' => false,		'qpf' => false,				'snow' => false,	
	'sky' => false,			'rh' => false,			'wspd' => false,			'wdir' => false,	
	'wx' => false,			'icons' => false,		'waveh' => false,			'incw34' => false,	
	'incw50' => false,		'incw64' => false,		'cumw34' => false,			'cumw50' => false,	
	'cumw64' => false,		'wgust' => false,		'conhazo' => false,			'ptornado' => false,	
	'phail' => false,		'ptstmwinds' => false,	'pxtornado' => false,		'pxhail' => false,	
	'pxtstmwinds' => false,	'ptotsvrtstm' => false,	'pxtotsvrtstm' => false,	'tmpabv14d' => false,	
	'tmpblw14d' => false,	'tmpabv30d' => false,	'tmpblw30d' => false,		'tmpabv90d' => false,	
	'tmpblw90d' => false,	'prcpabv14d' => false,	'prcpblw14d' => false,		'prcpabv30d' => false,	
	'prcpblw30d' => false,	'prcpabv90d' => false,	'prcpblw90d' => false,		'precipa_r' => false,	
	'sky_r' => false,		'td_r' => false,		'temp_r' => false,			'wdir_r' => false,	
	'wwa' => false,			'wspd_r' => false)
	
					);

try
{
	/* create the nuSOAP object */
	$c = new nusoap_client('http://www.weather.gov/forecasts/xml/DWMLgen/wsdl/ndfdXML.wsdl', 'wsdl');
	
	/* make the request */
	$result = $c->call('NDFDgen', $parameters);
}
catch (Exception $ex)
{
	/* nuSOAP throws an exception is there was a problem fetching the data */
	echo 'failed';
}

header('Content-type: text/xml');
echo $result;

/* ?> */

    More tips can now be found here: More Examples with Parsing NDFD Data in PHP

    No related posts.

    ]]>     http://phpstarter.net/2009/02/parse-weather-forecast-data-from-the-ndfd-in-php/feed/ 15