<?php
/*
PHP script by Mike Challis, www.642weather.com/weather
Weather Underground Web Cam Image Upload PHP Script - php-cam-image-upload.php
Script available at: http://www.642weather.com/weather/scripts-weather-cam-uploader.php
Contact Mike: http://www.642weather.com/weather/contact_us.php
Version: 1.1  09-Jan-2008

Version: 1.0  08-Jan-2008 - Initial release
Version: 1.1  09-Jan-2008 - Added better error results

You are free to use and modify the code for your own non-commercial use

This php code provided "as is", and Long Beach Weather (Michael Challis)
disclaims any and all warranties, whether express or implied, including
(without limitation) any implied warranties of merchantability or
fitness for a particular purpose.

License:
    This work is licensed under a
    CREATIVE COMMONS ATTRIBUTION - NONCOMMERCIAL 3.0
    UNITED STATES LICENSE
    For Complete Details please go to:
    http://creativecommons.org/licenses/by-nc/3.0/us/

################
# What does it do?
# ##############

Upload a web cam image to a WebCam account at wunderground.com
You might not even need this script though... If your cam software can ftp,
you can just ftp it directly to a WebCam account at wunderground.com

I use this script because I put a weather text overlay on the image with some
of my weather station's data from a PHP script before I upload it.
That can be all done from a windows PC with Weather Display software,
but I prefer the flexibility of using my PHP method.

I do the text overlay with my free Multifunction Image Handler PHP Script.
See the Script and Live Demo at
http://www.642weather.com/weather/scripts-image-handler.php
Here is a detailed guide how to use it to overlay text from your weather station data
http://www.642weather.com/weather/scripts-weather-cam-text.php

################
# What do I need?
# ##############

.. Web Cam installed on a personal PC.
.. Web cam software capable of uploading to a web site.
.. I use webcamcapture.exe that is included within Weather-Display Software
.. http://www.weather-display.com/index.php
.. Web server hosting account with PHP support
.. Ability to schedule a cron job from your web server
or a scheduler program on your PC that can ping a URL every 5 minutes.
.. WebCam account at wunderground.com
.. http://www.wunderground.com/webcams/signup.html

################
# How to use it:
# ##############

1) Setup your web cam software to take a snapshot at like every 5 minutes
and configure it to upload it as a .jpg to your web server.
wunderground file size limitation is 150K, make sure your web cam file size is well under 150k.
My cam image is 640 x 480 and around 100k

2) Create a WebCam account at wunderground.com
http://www.wunderground.com/webcams/signup.html

3) Set your settings in the "settings" section below

4) Upload the contents of this file as a .php to your web server

5) Test from a URL, you will see "upload success" or "upload failed"
Example: http://www.yoursite.com/php-cam-image-upload.php

6) Schedule automatic timed updates: There are many ways to do this, I use method 1
but not every web host allows it.

Method 1: Schedule a server cron job to run this php file every 5 minutes.
Example using crontab -e: (first remove the # from the line below and change /path/to/ to your server path)
# 2,7,12,17,22,27,32,37,42,47,52,57 * * * * php /path/to/php-cam-image-upload.php 2>&1 > /dev/null
note: my cam uploads on the 5's, my text overlay cron runs a minute later on the 1 and 6,
this cron runs a min later on the 2 and 7
http://en.wikipedia.org/wiki/Cron

Method 2: Use Scheduled HTTP Request - Windows Task Scheduler to make a HTTP Request
to the URL http://www.yourwebsite.com/php-cam-image-upload.php every 5 minutes 
Scheduled HTTP Request - Windows Task Scheduler:
http://www.642weather.com/weather/wxblog/php-scripts/scheduled-http-request-windows-task-scheduler/

7) Visit wunderground.com and verify the cam image is uploading.
http://www.wunderground.com/webcams/index.html

*/

#################
# begin settings
# ##############

//FTP Hostname
$ftp_server =   'webcam.wunderground.com';
$ftp_username = 'YOUR_WU_USERNAME'; # change this to your WU username
$ftp_password = 'YOUR_WU_PASSWORD'; # change this to your WU password

// This is the name and location of the file on your local server to upload
// This is a server file path NOT A URL!
// change /path/to/your/ to the correct server path
$source_file = '/path/to/your/webcamimage.jpg';

#################
# end settings
#################

#####                                                                      #####
# Do not alter any code below this point in the script or it may not run properly.
#####                                                                      #####

//This is the name and location after upload to the FTP server
// DO NOT CHANGE THIS, IT IS WHAT webcam.wunderground.com NEEDS!
$destination_file = 'image.jpg';

if (file_exists($source_file)) {

  //connect to the server
  $conn_id = ftp_connect($ftp_server) or die ("Couldn't connect to $ftp_server");

  // try to login
  if (ftp_login($conn_id, $ftp_username, $ftp_password)) {
          echo "Connected as $ftp_username@$ftp_server<br>\n";
  } else {
          echo "Could not connect as $ftp_username - username and or password incorrect\n";
          //close the FTP connection
          ftp_close($conn_id);
          exit;
  }

  //upload the file
  if (ftp_put($conn_id, $destination_file, $source_file, FTP_BINARY)) {
          //ftp_put can upload files in ascii or binary,
          //ascii would have FTP_ASCII instead of FTP_BINARY
          //binary is the correct format for images
          echo 'uploaded success';
  } else {
          echo 'upload failed';
  }
} else {
        echo 'upload failed - source_file not found, check setting for source file path';
        exit;
}
//close the FTP connection
ftp_close($conn_id);
echo ' ... disconnected .... good bye';
?>