Drinking (Entry 1)

Drinking here is very different. Anyone can buy beer. It’s weird because there are vending machines where you can buy it, just like treats or pop. Drinking is more like  pop than something “special”. It seems that they think at lunch”oh, a beer might be good, or coke?”

The appropriate age to drink seems to be around 12-13 to start and at 15-16 just drink w/ the adults. For example,  we were at a club and my host sister wanted a drink (not a whole can) of beer, but her mom said no; but later on the way home my host mom offered her a cup of wine.

When someone gets a beer they offer everyone in the group a drink and if I say no, it’s no big deal. It’s just “ok you’re not thirsty”. If I say I don’t drink then they look at me funny for a second and then say ok. It’s no big deal and they don’t pressure me to drink.

Drinking at Carnival (Entry 2)

Brazilians know how to handle their beer? I have never seen so many drunks in my life. At Carnival everyone (almost) was drinking and drinking and…

All You Can Drink Night At the Club (Entry 3)

One night the disco had a special. Buy 1 beer for R$5.00 and trade your empty can for a new one, as many times as you want. So everyone gets plastered right away and then slows down. But what happens when you slow down? Your beer gets warm. And hey! If you can get a free beer with an empty can, why not dump your beer on the dance floor and…

There were 1/2 inch deep puddles everywhere

2012 Update

Not every 12-13 year old in Brazil is being given drinks on the side by their parents, but it happens a lot more than in the US. Not every 15-16 year old in Brazil gets plastered at parties and at the clubs, but the number drunk teenagers I hung out with back then only gets more disturbing the older I get. When I say drunk I’m not talking about just a slight buzz after a can, I really mean altered-state, crying on the floor drunk.

Part of the blessing and curse of being an exchange student is that the most outgoing people approach you first and invite you to join their circle of friends. It seems logical that there would be a correlation between being outgoing and doing social activities such as going to parties, clubs and bars as a group where drinking occurs.

I love the group of friends I made in Brazil, but at the same time I wish I would’ve had more friends who didn’t drink, or at least more friends who drank responsibly. It’s completely possible that if I had found a different groups of friends my perception would be that everyone in Brazil was a responsible drinker.

If you go to Brazil as a teetotaler like me or someone who loves getting really drunk, you will find plenty of people to be accepting of your stance on drinking.

Pizza

I can’t say for all pizza, but it is very different, but very good.

No tomato sauce, cream cheese instead, but not the same as Phillidelphia.

A typical pizza has shredded chicken, mozzarella cheese, a few tomato slices and a few black olives.

2012 Update

I’m not sure why that entry on Pizza was so short. I love Brazilian pizza, so here’s some more info.

Most pizzas don’t have much tomato sauce, if they do it’s generally a very thin layer. Pizzas are nearly always thin-crust and very often wood fired.

Most pizza places deliver, frequently by motorcycle. The motorcycles have fiberglass or metal hot boxes bolted on the back and zip around the city delivering deliciousness to your doorstep.

Some of my favorite Brazilian pizzas include:

Frango com Catupiry — Shredded chicken and Catupiry cheese. Catupiry is a creamy cheese with the uncookced consistency of corn starch mixed with water. It’s got a creamy, delicious, salty, taste and goes really well with the chicken.

Frango com Milho Verde — Shredded chicken and corn. Milho verde is like sweet corn, but not sweet — just large fresh kernels.

Gorgonzola — You can get gorgonzola cheese in the US, but I’ve never seen it on a pizza here (except at my house!). It’s got a strong flavor and goes well on a pizza with thinly sliced onions.

Margherita — A traditional Italian pizza with just buffalo mozzerella, basil and tomato. When wood fired it’s deliciously simple.

Desert pizzas are also prominent, but I’ve never liked desert pizza. I would rather have real pizza for desert than desert pizza.

Pizza Rodizios

A Rodizio is a brazilian steak house where the servers carry various cuts of meat to your table and you eat from each type until you’re stuffed. If you’re lucky you’ll also run into a pizza rodizio where they bring all sorts of types of pizza by your table and you eat till you’re stuffed. The pizza at the pizza rodizios aren’t usually as high of quality, but you get to try a lot of flavors and it’s lots of fun.

Toilets

No toilet seats! But the hole is smaller so its no problem. By most house toilets, but not public restrooms, there is a bidet.

It’s true, water really does go backwards down the pot. But, 2 things: 1) I think I’m not far enough south to get the full effect and 2) the way the water is pressurized out it spashes at the bottom so there’s no nice neat smooth spin.

It just so happens I have a high-tec toilet; it accepts TP. Many many exchange students say no, don’t put toilet paper in the toilet, but I asked an I can.

Showers

In most places in Brazil there isn’t heated house water. So showers work a little different. Basically as the cold water comes out, an electronic heater in the shower head heats it. What at the books said is:

1.  Turn water on
2. Put sandals on to protect yourself from shocks
3. Turn on heater
4. Shower
5. Turn off heater
6. Turn off water

If you use the heater without water you can short out the room or building…or house.

Most showers in the USA come sideways from the wall. The ones I’ve seen here come out and drop the water straight down.

2012 Update

I wanted to believe that the water went down counterclockwise. If it did though, it wasn’t because of where I was relative to the equator.

Lots of toilets in Brazil do have toilet seats, but lots don’t. The nicer the bathroom is, the more likely that there will be a seat.

When I went back to Brazil as a missionary I was in Sao Paulo and I never encountered a toilet that wouldn’t take toilet paper in real buildings in the city. The only places I found those was in places where DIY plumbing left the toilets with extremely low water pressure — mainly in favelas and in small self-built rural homes.

One other thing I didn’t note back in 1998 is that toilets in Brazil come in way more colors than in the USA. Black, red, blue, yellow, marbled…lots of colors. You can find colored toilets in the US, but they’re not nearly as common as in Brazil.

When I went to Brazil as an exchange student I must have caught the tail end of a transition from manual-on shower heads to automatic-on showerheads. The books I read before leaving gave lots of warnings about turning on the water first and avoiding shocks. I only ran into a couple of places where that was an issue.

For the most part the showerheads now have water sensors that turn the heater on and off automatically when the water comes on. As long as it has been installed and grounded correctly you won’t get any shocks either. There was only one shower I used where you could feel the electric current running through the faucet handle, but only if you had a hangnail.

Describe Sacramento, Minas Gerais, Brazil

Well…First the roofs. Almost every roof is either red clay shingles or corrugated metal or plastic. The building show a strong trend towards cement, stucco and tiles. The average building is 2-3 stories tall. The sidewalks are stone with stones about 1 foot or 1/2 foot across and wide. The roads are organized cobblestone. Each rock looks the same color and is cut almost the same size. In the middle of the road every 10-15 feet is a tree, some kind of palm.

The highways however are paved and much smoother than Ironwoods.

Driving laws are different. I think there isn’t as much respect for the centerline, speed limit or pedestrians.

2012 Update

I now know that the roads weren’t cobblestone, they used Sett Paving. If I had spent any time at all in California before going to Brazil, I would have described the architecture as Spanish Mission Style.

I’ve got 113 reels of microfilm I’d like to digitize and I’m looking for a ballpark estimate for the project.

Here’s the info I know, please let me know if you need anything else:

• There are an average of 600 images per reel (about 67,800 images)
• I’d like to scan at 300 dpi, 8bit grayscale lossless images (tiff? png?)
• I have the copyright on the images on these reels
• The reels are lightly used duplicates of the master reels. The master reels are unfortunately unavailable
• The images are all scanned newspapers
• I don’t need any OCR done
• The only metadata I need is which reel each of the images came from eg. One directory per reel with incremental file names would be just fine.

Project Background: I would like to put 128 years of Iron County Miner newspaper archives online. They would be freely available (no subscription or account required) and there’s no plan to make money from them. Since there’s no revenue expected I’m looking for ways to reduce costs while still putting something out there to benefit genealogists and historians.

The master rolls are held by the Wisconsin Historical Society who wants nearly $10,000 ($0.145/image) for the project or $80 per reel to send us fresh copies of the reels. From their perspective, I think that’s probably fair; they aren’t in the digitization business and they probably aren’t set up to do this sort of project in a streamlined manner. They also can’t amortize their digitization equipment costs across so many clients as a commercial company can.

For me though, $10,000 means that I can’t pursue this project right now.

Most digitization companies I have contacted have been reluctant to provide even a ballpark quote without seeing test reels, and I understand that that is a factor. Right now though, I just need a gauge to determine if this project is viable. If $10,000 is the real cost for this sort of project it will have to wait till I’m rich, but if I can get a cheaper quote I hope to make it happen this summer.

Pre-Announcing NewspaperCMS

I have been working on a CMS (Content Management System) called NewspaperCMS, to host the scanned images with and to make them easily navigable. It is licensed under the GPLv2 so anybody needing to host newspaper archives can use it.

Here’s its page on Google Code: http://code.google.com/p/newspapercms/

I would classify it as in late Alpha or early Beta stages right now. I’ll do an official post on it as it matures and as I get a publicly accessible test site set up. As a teaser, features include:

• Browse collection by microfilm, newspaper or date
  • Drill down within those categories by newspaper, issue, year or month
• Access-driven generation of midsized images. No need to generate 60,000 midsized images ahead of time.
• Valid HTML5/CSS3
• HTML5/Canvas based client-side image viewer. The user can zoom, rotate, invert, sharpen and change the contrast of the image (uses the http://www.pixastic.com/JavaScript libraries)
  • Falls back to a static image if they don’t have Canvas or JavaScript support
• Built in search engine
• Support for the tesseract OCR engine

As I said, it’s still in development, but if you need something like it, you can play with it now. It’s at the point where more development doesn’t make sense until I know I can get the microfilms scanned.

Zooming in on the image quickly causes the canvas to outgrow my browser window. The div around the canvas is set to use overflow: auto so that the growing canvas doesn’t disrupt the rest of the page flow.

<div id="pageimgdiv" style="max-width: 100%; overflow: auto;">
   <canvas>
      Your browser doesn't support HTML5 Canvas
   </canvas>
</div>

The overflowed div gains horizontal scrollbars (but not vertical ones, since there’s no max-height in my case). Unfortunately many people, including myself, don’t have horizontal scrolling configured for their mouse which means scrolling down to the scrollbar, moving over, then scrolling back up.

JQuery To The Rescue

I was able to use JQuery and the scrollLeft() function to make the canvas dragable within the div. The canvas itself doesn’t change sizes or pan (which would require a second canvas used as a buffer, I think). Instead we get the mouse position and current scrollLeft setting when the mouse is clicked, and then scroll more as they move the mouse, until they release the mouse or until they leave the wrapper div.

I’m using JQuery 1.7.2.

$(document).ready(function(){
    $('#pageimgdiv').on(
    {
	mousedown: function(clicke){
	    origX = clicke.pageX + $('#pageimgdiv').scrollLeft();
	    $('#pageimgdiv').on(
	    {
		mousemove : function(e){
		    curX = e.pageX + $('#pageimgdiv').scrollLeft();
		    var diff = (origX - curX);
		    var newpos = $('#pageimgdiv').scrollLeft() + diff;
		    if(newpos > ($('canvas').width() - $('#pageimgdiv').width())){
			newpos = ($('canvas').width() - $('#pageimgdiv').width());
		    }
		    if(newpos < 0){
			newpos = 0;
		    }
		    $('#pageimgdiv').scrollLeft(newpos);
		}
	    }
	    );
	},
	mouseleave: function(){
	    $('#pageimgdiv').off('mousemove');
	},
	mouseup: function(){
	    $('#pageimgdiv').off('mousemove');
	},
	click: function(){
	    $('#pageimgdiv').off('mousemove');
	}
    }
    );
});

Embrace and Extend

This code only scrolls horizontally. You could easily extend it to use scrollTop() and enable vertical scrolling as well.

Most Xdebug/NetBeans tutorial assume that you’re doing development on your local machine. That’s a fine setup, but not what I was needed for this project.

Environment

Server: A typical Linux server — Debian, Apache2 and PHP.

Debugger: Xdebug

Client: Firefox on Windows, etc.

IDE: NetBeans 7.1.1

Other Tools: PuTTY

Setting Up Xdebug

Install xdebug with the command:

pecl install xdebug

The final lines of output should say something like:

Build process completed successfully
Installing '/usr/lib/php5/20090626/xdebug.so'
install ok: channel://pecl.php.net/xdebug-2.2.

Take note of the install path, /usr/lib/php5/20090626/xdebug.so, in this case. Now add the following to your PHP configuration. I created a new .ini file at

/etc/php5/conf.d/xdebug.ini

Its contents should be as follows (change the zend_extension to match the install path found above):

[xdebug]
zend_extension = "/usr/lib/php5/20090626/xdebug.so"

xdebug.remote_enable = on

; Most users won't want autostart. More on this later.
; xdebug.remote_autostart = on
xdebug.remote_autostart = off
xdebug.remote_handler = dbgp
xdebug.remote_port = 9000
xdebug.remote_server = localhost
xdebug.remote_mode = req

; Most users won't want a hard coded idekey. More on this later.
; xdebug.idekey = netbeans-xdebug
output_buffering = off

xdebug.remote_log = "/var/log/xdebug.log"

Restart Apache to complete the installation.

xdebug.remote_server = localhost. Localhost? Wait a second, I thought this was for working with a remote server? Yes, but xdebug needs to be able to connect to your computer. The easy option is to have xdebug connect to the server’s localhost, then use PuTTY to create an SSH tunnel so that NetBeans can listen on your computer’s localhost.

The harder option is to configure your home or office router to forward port 9000 to you, be sure to never change your IP address, and open port 9000 on your Windows firewall. You could use xdebug.remote_connect_back so that xdebug would connect to whichever IP made the web request, but then someone who isn’t you could access your code.

In my opinion, the SSH tunneling is the cleanest option. You can use it anywhere that you have SSH access, xdebug access is restricted to those who have SSH access and you don’t have to worry about your IP address changing.

Creating an SSH Tunnel for Xdebug

Using PuTTY.exe create and save a new SSH session which connects to your server. In this saved session configure a tunnel. Set the source port to 9000, the destination to localhost:9000, and choose the Remove and Auto radio buttons. Click the Add button to add that port forwarding configuration, then save that session to use every time you want to use xdebug.

Go ahead and connect to that saved PuTTY session now. Once you’re connected to your server you should be able to run netstat to verify that it’s working correctly. It should show something like this:

netstat -a -n | grep 9000
tcp        0      0 127.0.0.1:9000          0.0.0.0:*               LISTEN
tcp6       0      0 ::1:9000                :::*                    LISTEN

Setting up NetBeans

Set up your NetBeans project like you usually would. Verify that the PHP Debugging Settings (In the Tools->Options menu) are set to debugger port 9000, and the Session ID of netbeans-xdebug. I had problems with the Watches and Balloon Evaluation options. YMMV.

In your project properties (Right click your project, click Properties) edit the Run Configuration’s Advanced properties. Select “Do Not Open Web Browser”.

A Note on Path Mappings

Based on the tutorials I read, most users don’t seem to need Path Mappings. NetBeans seems to figure out the path based on the upload directory, the URL and the Web Root settings.  That didn’t work for me. I needed Path Mapping because I had a symlink on the server.

PHP (and so Xdebug) dereferences symlinks and NetBeans needs the mapping between the dereferenced path on the server and the local sources directory.

This is a known issue, but not very well known. Symptoms that you need to  use mapping include NetBeans not breaking in symlinked files, NetBeans not opening the file or not opening the correct file when Xdebug connection is made. Or it may work only if you use “Debug File” instead of “Debug Project”.

 Debugging With Xdebug and NetBeans

Here’s where you have some options. The manual way to active Xdebug is to append XDEBUG_SESSION_START=netbeans-xdebug to your query string when you request a page in the browser. With the current setup, this should work. Go ahead and test it.

Choose Debug -> Debug Project from the NetBeans menu. Then, in your browser, go to http://example.com/path/to/page.php??XDEBUG_SESSION_START=netbeans-xdebug (replacing the URL with your own, of course).

If that doesn’t work then something isn’t set up correctly. It might be NetBeans, it might be Xdebug, it might be the SSH tunnel. Figure it out, get it fixed, then keep reading (you can leave comments here, and I’ll help as I can. Google is pretty helpful too).

If that does work, then GREAT!

Now you have some options.

Browser Extensions

Firefox and Chrome both have Xdebug extensions that set the XDEBUG_SESSION_START parameter in the http headers. This makes it so you don’t have to type it yourself.  Yay Firefox. Yay Chrome.

Always Auto-start Xdebug

If you are testing embedded webkit, or from mobile devices, or something else that’s not a normal browser, then appending XDEBUG_SESSION_START is going to be difficult. This is where I send you back to your xdebug.ini file to change some settings. If you need to debug requests from these sorts of devices, then you’re going to want to edit xdebug.ini and set:

xdebug.remote_autostart = on
xdebug.idekey = netbeans-xdebug

This will cause Xdebug to attempt to connect on port 9000 on every request. The idekey setting is so that NetBeans will know that the connection is for it.

Other PHP Debugging Tools

If you are looking for good PHP debugging tools, you may also want to try out KCacheGrind which will profile your code giving you an idea what’s taking up time and memory. HipHop-PHP, a tool from Facebook of all places, compiles PHP into C++. In the process it spits out all sorts of helpful errors and notices that will help you find errors in your code.

That concludes one more NetBeans Xdebug tutorial that will hopefully get you that much closer to doing some serious PHP debugging. Happy coding!

You might want to always append a trailing slash if you depend on it in $_SERVER['REDIRECT_URL'] or if you want to ensure that content is only available via a single URL for search engines etc.

Here’s the Apache mod_rewrite code:

<IfModule mod_rewrite.c>
RewriteEngine On

# Always append a trailing slash
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteCond %{REQUEST_URI} !/$
RewriteRule . %{REQUEST_URI}/ [R=301,L]

</IfModule>

The plugin is named Todayish because if there isn’t a blog post from today’s
date in previous years it will use the blog post which is the least
number of days away from todays date.

Todayish in History provides a function for use in themes as well as a
widget for use in your sidebar.

Todayish In History’s Homepage

Todayish In History has a permanent home at http://stuporglue.org/todayish-in-history/.

Hopefully this proves to be a useful plugin for someone. Please send me any feedback. You can use the comments, the contact page, or email me at stuporglue@gmail.com.

Screenshots

Demo

You can see Todayish In History in action at the top of every page over at The Fridley Farmer.

At first I suggested that people needed more robust email parsing use a dedicated library. But no one seemed to want to do the coding for that, so I ended up writing a new version which uses the PEAR mimeDecode.php library to do the parsing.

Without further ado, here’s mailReader.php!

E-mail Processing Script Features:

1. Saves the e-mail sender, subject and body to a database
2. Saves any attachments as files and creates an entry for those files in the database, associated with the e-mail info in #1
3. Sends  a response back to the sender telling them what files were received and their file sizes
4. Checks a list of allowed senders to make sure we only take files from specified addresses.

Database Setup:

If you’re going to use the database features, you’ll need a database. Here’s the SQL to create an identical setup to the one I have:

-- Here's my DB structureCREATE TABLE IF NOT EXISTS `emails` (
  `id` int(255) NOT NULL AUTO_INCREMENT,
  `from` varchar(255) COLLATE utf8_unicode_ci NOT NULL,
  `subject` varchar(255) COLLATE utf8_unicode_ci NOT NULL,
  `body` text COLLATE utf8_unicode_ci NOT NULL,
  `date` timestamp NOT NULL DEFAULT '0000-00-00 00:00:00' ON UPDATE CURRENT_TIMESTAMP,
  PRIMARY KEY (`id`)
) ENGINE=MyISAM DEFAULT CHARSET=utf8 COLLATE=utf8_unicode_ci AUTO_INCREMENT=1 ;

CREATE TABLE IF NOT EXISTS `files` (
  `id` int(255) NOT NULL AUTO_INCREMENT,
  `email_id` int(255) NOT NULL,
  `filename` varchar(255) COLLATE utf8_unicode_ci NOT NULL,
  `size` varchar(20) COLLATE utf8_unicode_ci NOT NULL,
  `mime` varchar(100) COLLATE utf8_unicode_ci NOT NULL,
  PRIMARY KEY (`id`)
) ENGINE=MyISAM DEFAULT CHARSET=utf8 COLLATE=utf8_unicode_ci AUTO_INCREMENT=1 ;

Security

Make sure that your upload directory is out of your webroot. If someone emails you a malicious PHP script (eg. Virus.php) and can access it via the web, they could infect your server or your visitors. Many servers are configured to automatically treat .pl and .cgi as CGI scripts and run them as well. You do not want to create a way for untrusted users to upload files to your webroot!

With the file names in the database you can use Readfile to pass files down to users.

The Script: mailReader.php

Download it here.

#!/usr/bin/php -q
<?php
//  Use -q so that php doesn't print out the HTTP headers

/*
 * mailReader.php
 *
 * Recieve mail and attachments with PHP
 *
 * Usage:
 * This script expects to recieve raw emails via STDIN.
 *
 * Configure your mail server to pipe emails to this script. (See
 * http://stuporglue.org/add-an-email-address-that-forwards-to-a-script/
 * for instructions).  Make this script executable, and edit the
 * configuration options to suit your needs. Change permissions
 * of the directories so that the user executing the script (probably the
 * mail user) will have write permission to the file upload directory.
 *
 * By default the script is configured to save pdf, zip, jpg, png and gif files.
 * Edit the switch statements around line 200 to change this.
 *
 * Requirements:
 * You will need mimeDecode.php from http://pear.php.net/package/Mail_mimeDecode/
 * I used version 1.5.5
 *
 * Copyright 2012, Michael Moore
 * Licensed under the same terms as PHP itself. You are free to use this script
 * for personal or commercial projects. Use at your own risk. No guarantees or
 * warranties.
 *
 * Contact:
 * <stuporglue@gmail.com>
 * http://stuporglue.org
 *
 * Support:
 * Limited free support available in the comments on the webpage for this script
 * or via email. Contracted support available for specific projects.
 * http://stuporglue.org/mailreader-php-parse-e-mail-and-save-attachments-php-version-2/
 *
 * Thanks:
 * Many thanks to forahobby of www.360-hq.com for testing this script and helping me find
 * the initial bugs.
 * Thanks to Craig Hopson of twitterrooms.co.uk for help tracking down an iOS email handling bug.
 */

global $save_directory,$saved_files,$debug,$body;

/*
 *
 * 	Configuration Options
 *
 */

// What's the max # of seconds to try to process an email?
$max_time_limit = 600; 

// A safe place for files WITH TRAILING SLASH
// Malicious users could upload a php or executable file,
// so keep this out of your web root
$save_directory = "/a/safe/save/directory/";

// Allowed senders is now just the email part of the sender (no name part)
$allowed_senders = Array(
    'myemail@example.com',
    'whatever@example.com',
); 

// Send confirmation e-mail back to sender?
$send_email = FALSE; 

// Save e-mail message and file list to DB?
$save_msg_to_db = FALSE; 

// Configure your MySQL database connection here
$db_host = 'localhost';
$db_un = 'db_un';
$db_pass = 'db_pass';
$db_name = 'db_name';

$debug = FALSE;

/*
 *
 * 	End of Configuration Options
 *
 */

//Anything printed to STDOUT will be sent back to the sender as an error!
//error_reporting(-1);
//ini_set("display_errors", 1);

// Initialize the other global, set PHP options, load email library
$saved_files = Array();
set_time_limit($max_time_limit);
ini_set('max_execution_time',$max_time_limit);
require_once('mimeDecode.php');

// Some functions we'll use
function formatBytes($bytes, $precision = 2) {
    $units = array('B', 'KB', 'MB', 'GB', 'TB');

    $bytes = max($bytes, 0);
    $pow = floor(($bytes ? log($bytes) : 0) / log(1024));
    $pow = min($pow, count($units) - 1);

    $bytes /= pow(1024, $pow);

    return round($bytes, $precision) . ' ' . $units[$pow];
} 

// Find a happy place! Find a happy place!
function saveFile($filename,$contents,$mimeType){
    global $save_directory,$saved_files,$debug;
    $filename = preg_replace('/[^a-zA-Z0-9_-]/','_',$filename);

    $unlocked_and_unique = FALSE;
    while(!$unlocked_and_unique){
	// Find unique
	$name = time() . "_" . $filename;
	while(file_exists($save_directory . $name)) {
	    $name = time() . "_" . $filename;
	}

	// Attempt to lock
	$outfile = fopen($save_directory.$name,'w');
	if(flock($outfile,LOCK_EX)){
	    $unlocked_and_unique = TRUE;
	}else{
	    flock($outfile,LOCK_UN);
	    fclose($outfile);
	}
    }

    fwrite($outfile,$contents);
    fclose($outfile);

    // This is for readability for the return e-mail and in the DB
    $saved_files[$name] = Array(
	'size' => formatBytes(filesize($save_directory.$name)),
	'mime' => $mimeType
    );
}

function decodePart($body_part){
    global $body,$debug;
    if(array_key_exists('name',$body_part->ctype_parameters)){ // everyone else I've tried
	$filename = $body_part->ctype_parameters['name'];
    }else if($body_part->ctype_parameters && array_key_exists('filename',$body_part->ctype_parameters)){ // hotmail
	$filename = $body_part->ctype_parameters['filename'];
    }else{
	$filename = "file";
    }

    if($debug){
	print "Found body part type {$body_part->ctype_primary}/{$body_part->ctype_secondary}\n";
    }

    $mimeType = "{$body_part->ctype_primary}/{$body_part->ctype_secondary}"; 

    switch($body_part->ctype_primary){
    case 'text':
	switch($body_part->ctype_secondary){
	case 'plain':
	    $body = $body_part->body; // If there are multiple text/plain parts, we will only get the last one.
	    break;
	}
	break;
    case 'application':
	switch ($body_part->ctype_secondary){
	case 'pdf': // save these file types
	case 'zip':
	case 'octet-stream':
	    saveFile($filename,$body_part->body,$mimeType);
	    break;
	default:
	    // anything else (exe, rar, etc.) will faill into this hole and die
	    break;
	}
	break;
    case 'image':
	switch($body_part->ctype_secondary){
	case 'jpeg': // Save these image types
	case 'png':
	case 'gif':
	    saveFile($filename,$body_part->body,$mimeType);
	    break;
	default:
	    break;
	}
	break;
    case 'multipart':
	if(is_array($body_part->parts)){
	    foreach($body_part->parts as $ix => $sub_part){
		decodePart($sub_part);
	    }
	}
	break;
    default:
	// anything else isn't handled
	break;
    }
}

//
// Actual email handling starts here!
// 

// Process the e-mail from stdin
$fd = fopen('php://stdin','r');
$raw = '';
while(!feof($fd)){ $raw .= fread($fd,1024); }

// Uncomment this for debugging.
// Then you can do
// cat /my/saved/file.raw | ./mailReader.php
// for testing
//file_put_contents("$save_directory/" . time() . "_email.raw",$raw);

// Now decode it!
// http://pear.php.net/manual/en/package.mail.mail-mimedecode.decode.php
$decoder = new Mail_mimeDecode($raw);
$decoded = $decoder->decode(
    Array(
	'decode_headers' => TRUE,
	'include_bodies' => TRUE,
	'decode_bodies' => TRUE,
    )
);

// Set $from_email and check if it's allowed
$from = $decoded->headers['from'];
$from_email = preg_replace('/.*<(.*)>.*/',"$1",$from);
if(!in_array($from_email,$allowed_senders)){
    die("$from_email not an allowed sender");
}

// Set the $subject
$subject = $decoded->headers['subject'];

// Find the email body, and any attachments
// $body_part->ctype_primary and $body_part->ctype_secondary make up the mime type eg. text/plain or text/html
if(is_array($decoded->parts)){
    foreach($decoded->parts as $idx => $body_part){
	decodePart($body_part);
    }
}

// $from_email, $subject and $body should be set now. $saved_files should have
// the files we captured

// Put the results in the database if needed
if($save_msg_to_db){
    mysql_connect($db_host,$db_un,$db_pass);
    mysql_select_db($db_name);

    $q = "INSERT INTO `emails` (`from`,`subject`,`body`) VALUES ('" .
	mysql_real_escape_string($from_email) . "','" .
	mysql_real_escape_string($subject) . "','" .
	mysql_real_escape_string($body) . "')";

    mysql_query($q) or die(mysql_error());

    if(count($saved_files) > 0){
	$id = mysql_insert_id();
	$q = "INSERT INTO `files` (`email_id`,`filename`,`size`,`mime`) VALUES ";
	$filesar = Array();
	foreach($saved_files as $f => $data){
	    $filesar[] = "('$id','" .
		mysql_real_escape_string($f) . "','" .
		mysql_real_escape_string($data['size']) . "','" .
		mysql_real_escape_string($data['mime']) . "')";
	}
	$q .= implode(', ',$filesar);
	mysql_query($q) or die(mysql_error());
    }
}

// Send response e-mail if needed
if($send_email && $from_email != ""){
    $to = $from_email;
    $newmsg = "Thanks! I just uploaded the following ";
    $newmsg .= "files to your storage:\n\n";
    $newmsg .= "Filename -- Size\n";
    foreach($saved_files as $f => $s){
	$newmsg .= "$f -- $s\n";
    }
    $newmsg .= "\nI hope everything looks right. If not,";
    $newmsg .=  "please send me an e-mail!\n";

    mail($to,$subject,$newmsg);
}

if($debug){
    print "From : $from_email\n";
    print "Subject : $subject\n";
    print "Body : $body\n";
    print "Saved Files : \n";
    print_r($saved_files);
}

Thanks

Many thanks to forahobby for testing this script and helping me squash a bunch of little bugs. Thanks to Craig Hopson for his help finding a problem handling emails from iOS devices.