In situations where your PHP application needs to store entire files, the preferred method is to save the file onto the server’s file-system, and store the physical location of the file in your database. This is generally considered to be the easiest and fastest way to store files.
However, you may find yourself in situations where you would want to keep the file itself with the other data in your database. This gives you - or rather: MySQL - complete control over the file data, rather than just the location of the file on the server.
There are some downsides to this method though, such as; decreased performance and added complexity to both your PHP code and your database structure. This is something you should carefully consider before using this in a real-life application.
Having said that, this article demonstrates how you can upload a file from a browser into MySQL, and how to send the files back to the browser.
Before you start
To get through this smoothly, you should be familiar with the following:
The battle plan
As with all programs, before we start writing we need to plan a little ahead. Just so we know what we are going to write before we write it.
Before we start on the program, we need to design the database. This is not a complex design, as we are not talking about creating some complex filing system. We only need a single table, containing a BLOB field for our file and various other fields to store information on our file, such as name, size, type.
Now then. The first phase of the program is getting the file from our users onto the server where our PHP can interact with it. This is the simplest part of the process, requiring only a basic HTML form.
The second phase involves reading the uploaded file, making sure it was uploaded successfully and adding it to the database. This is a similar process as the one used when uploading a file to the file-system, but using the MySQL functions rather than the file-system functions.
The third phase is to list all files that have been uploaded and saved on the database, with a link so it can be downloaded. The only problem here would be the fact that the file does not exists on the server, so how do we create a link to it? That is a problem handled by phase 4, all we need to do in phase 3 is create a link with the ID of the file to be downloaded embedded in the URL.
The fourth, and final, part is the one that is most confusing about this process. The part where we fetch the file and send it to the client's browser.
We start by using the MySQL functions, and the ID sent by phase 3, to fetch the file data from the database. Then we set a few headers, letting the browser know what to expect, before finally sending the contents of the file.
Now, using this summary as a guide, lets start writing our program.
Phase 0: Building a database
The database is simple. One table with a BLOB field for the file data and a few fields for various pieces of information relating to the file:
Expand|Select|Wrap|Line Numbers
- CREATE TABLE `file` (
- `id` Int Unsigned Not Null Auto_Increment,
- `name` VarChar(255) Not Null Default 'Untitled.txt',
- `mime` VarChar(50) Not Null Default 'text/plain',
- `size` BigInt Unsigned Not Null Default 0,
- `data` MediumBlob Not Null,
- `created` DateTime Not Null,
- PRIMARY KEY (`id`)
- )
We have the mime type, which we use to let the browser know what kind of file we are dealing with.
The size of the file in bytes.
And finally the data itself, in a MediumBlob field.
Phase 1: Uploading the file
Now, we need to get the file from the user. The table we designed does not require any additional information from the user, so we will make this simple and create a HTML form with only a single "file" input field and a submit button:
Expand|Select|Wrap|Line Numbers
- <!DOCTYPE html>
- <head>
- <title>MySQL file upload example</title>
- <meta http-equiv="content-type" content="text/html; charset=UTF-8">
- </head>
- <body>
- <form action="add_file.php" method="post" enctype="multipart/form-data">
- <input type="file" name="uploaded_file"><br>
- <input type="submit" value="Upload file">
- </form>
- <p>
- <a href="list_files.php">See all files</a>
- </p>
- </body>
- </html>
If it is set any other way, or not set at all, your file is probably not going to be transmitted correctly.
At the bottom, we have a link to the list we will create in phase 3.
Phase 2: Add the file to the database
In the form we built in phase 1, we set the action property to "add_file.php". This is the file we are going to build it this phase of the process.
This file needs to check if a file has been uploaded, make sure it was uploaded without errors, and add it to the database:
Expand|Select|Wrap|Line Numbers
- <?php
- // Check if a file has been uploaded
- if(isset($_FILES['uploaded_file'])) {
- // Make sure the file was sent without errors
- if($_FILES['uploaded_file']['error'] == 0) {
- // Connect to the database
- $dbLink = new mysqli('127.0.0.1', 'user', 'pwd', 'myTable');
- if(mysqli_connect_errno()) {
- die("MySQL connection failed: ". mysqli_connect_error());
- }
- // Gather all required data
- $name = $dbLink->real_escape_string($_FILES['uploaded_file']['name']);
- $mime = $dbLink->real_escape_string($_FILES['uploaded_file']['type']);
- $data = $dbLink->real_escape_string(file_get_contents($_FILES ['uploaded_file']['tmp_name']));
- $size = intval($_FILES['uploaded_file']['size']);
- // Create the SQL query
- $query = "
- INSERT INTO `file` (
- `name`, `mime`, `size`, `data`, `created`
- )
- VALUES (
- '{$name}', '{$mime}', {$size}, '{$data}', NOW()
- )";
- // Execute the query
- $result = $dbLink->query($query);
- // Check if it was successfull
- if($result) {
- echo 'Success! Your file was successfully added!';
- }
- else {
- echo 'Error! Failed to insert the file'
- . "<pre>{$dbLink->error}</pre>";
- }
- }
- else {
- echo 'An error accured while the file was being uploaded. '
- . 'Error code: '. intval($_FILES['uploaded_file']['error']);
- }
- // Close the mysql connection
- $dbLink->close();
- }
- else {
- echo 'Error! A file was not sent!';
- }
- // Echo a link back to the main page
- echo '<p>Click <a href="index.html">here</a> to go back</p>';
- ?>
So, now that we have a couple of files in our database, we need to create a list of files and link them so they can be downloaded:
Expand|Select|Wrap|Line Numbers
- <?php
- // Connect to the database
- $dbLink = new mysqli('127.0.0.1', 'user', 'pwd', 'myTable');
- if(mysqli_connect_errno()) {
- die("MySQL connection failed: ". mysqli_connect_error());
- }
- // Query for a list of all existing files
- $sql = 'SELECT `id`, `name`, `mime`, `size`, `created` FROM `file`';
- $result = $dbLink->query($sql);
- // Check if it was successfull
- if($result) {
- // Make sure there are some files in there
- if($result->num_rows == 0) {
- echo '<p>There are no files in the database</p>';
- }
- else {
- // Print the top of a table
- echo '<table width="100%">
- <tr>
- <td><b>Name</b></td>
- <td><b>Mime</b></td>
- <td><b>Size (bytes)</b></td>
- <td><b>Created</b></td>
- <td><b> </b></td>
- </tr>';
- // Print each file
- while($row = $result->fetch_assoc()) {
- echo "
- <tr>
- <td>{$row['name']}</td>
- <td>{$row['mime']}</td>
- <td>{$row['size']}</td>
- <td>{$row['created']}</td>
- <td><a href='get_file.php?id={$row['id']}'>Download</a></td>
- </tr>";
- }
- // Close table
- echo '</table>';
- }
- // Free the result
- $result->free();
- }
- else
- {
- echo 'Error! SQL query failed:';
- echo "<pre>{$dbLink->error}</pre>";
- }
- // Close the mysql connection
- $dbLink->close();
- ?>
This part is the one that usually causes the most confusion.
To really understand how this works, you must understand how your browser downloads files. When a browser requests a file from a HTTP server, the server response will include information on what exactly it contains. These bits of information are called headers. The headers usually include information on the type of data being sent, the size of the response, and in the case of files, the name of the file.
There are of course a lot of other headers, which I will not cover here, but it is worth looking into!
Now, this code. We start simply by reading the ID sent by the link in phase 3. If the ID is valid, we fetch the information on the file who's ID we received, send the headers, and finally send the file data:
Expand|Select|Wrap|Line Numbers
- <?php
- // Make sure an ID was passed
- if(isset($_GET['id'])) {
- // Get the ID
- $id = intval($_GET['id']);
- // Make sure the ID is in fact a valid ID
- if($id <= 0) {
- die('The ID is invalid!');
- }
- else {
- // Connect to the database
- $dbLink = new mysqli('127.0.0.1', 'user', 'pwd', 'myTable');
- if(mysqli_connect_errno()) {
- die("MySQL connection failed: ". mysqli_connect_error());
- }
- // Fetch the file information
- $query = "
- SELECT `mime`, `name`, `size`, `data`
- FROM `file`
- WHERE `id` = {$id}";
- $result = $dbLink->query($query);
- if($result) {
- // Make sure the result is valid
- if($result->num_rows == 1) {
- // Get the row
- $row = mysqli_fetch_assoc($result);
- // Print headers
- header("Content-Type: ". $row['mime']);
- header("Content-Length: ". $row['size']);
- header("Content-Disposition: attachment; filename=". $row['name']);
- // Print data
- echo $row['data'];
- }
- else {
- echo 'Error! No image exists with that ID.';
- }
- // Free the mysqli resources
- @mysqli_free_result($result);
- }
- else {
- echo "Error! Query failed: <pre>{$dbLink->error}</pre>";
- }
- @mysqli_close($dbLink);
- }
- }
- else {
- echo 'Error! No ID was passed.';
- }
- ?>
The finish line
So, as you see, this is not as complex as one might think.
This code is of course only written for demonstration purposes and I would not recommend using it without adding a little extra security. Un-edited, this code would basically allow anybody to upload anything to your server, which is not a good idea!
I hope this has been helpful, and I wish you all the best.
See you around,
- Atli Þór
Revisions
- August 20th, 2008 - Replaced the old mysql functions with the improved mysqli functions.
- December 12th, 2009 - Updated the introduction to include a bit more detail on the pros and cons of this method. Also improved the code structure a bit. Replaced the mysqli procedural functions with their OOP counterparts. (Thanks to kovik for pointing out the need for these changes!)