Skip to content

Commit 2a9ac98

Browse files
rhedgpethrhedgpeth
committed
Initial additions
1 parent daa35a7 commit 2a9ac98

10 files changed

+452
-0
lines changed

‎README.md

+66
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,66 @@
1+
# PHP Quickstart
2+
3+
This repository contains a simple web application that demonstrates how to quickly connect to and communicate with a [MariaDB](https://mariadb.com) database using [PHP](https://www.php.net/).
4+
5+
<p align="center" spacing="10">
6+
<kbd>
7+
<img src="media/demo.gif" />
8+
</kbd>
9+
</p>
10+
11+
## Getting Started
12+
13+
The application in this repository demonstrates how to:
14+
15+
* Connect to a MariaDB database using [mysqli](https://www.php.net/manual/en/book.mysqli.php)
16+
* Execute queries (`SELECT`, `UPDATE`, `INSERT` and `DELETE`) to manage _contact_ data (like a digital [rolodex](https://en.wikipedia.org/wiki/Rolodex))
17+
* Use prepared statements
18+
19+
### Prepare the database
20+
21+
The application relies on a single database (`rolodex`) that contains a single table (`contacts`). You can find the necessary SQL for setting up the environment in [schema.sql](schema.sql).
22+
23+
### Run the application
24+
25+
After you've [pulled down this repository](https://git-scm.com/docs/git-clone), follow these steps to get the app up and running:
26+
27+
1. Update the database configuration settings in [config.php](src/config.php) (which is used across the app) to point to _your_ MariaDB database.
28+
29+
_Example configuration:_
30+
31+
```php
32+
$databaseHost = '127.0.0.1';
33+
$databaseUsername = 'user_name';
34+
$databasePassword = '********';
35+
$databaseName = 'rolodex';
36+
```
37+
38+
**Note:** Check out the [config_skysql.php](config_skysql.php) file for an example of how to connect to [MariaDB SkySQL](https://mariadb.com/skyview).
39+
40+
2. Run the application using the [built-in web server](https://www.php.net/manual/en/features.commandline.webserver.php).
41+
42+
```bash
43+
$ php -S localhost:5000
44+
```
45+
46+
## Helpful Resources
47+
48+
* [MariaDB Quickstart](https://github.com/mariadb-developers/mariadb-getting-started)
49+
* [Official MariaDB Documentation](https://mariadb.com/docs)
50+
51+
## Support and Contribution
52+
53+
Please feel free to submit PR's, issues or requests to this project directly.
54+
55+
If you have any other questions, comments, or looking for more information on MariaDB please check out:
56+
57+
* [MariaDB Developer Hub](https://mariadb.com/developers)
58+
* [MariaDB Community Slack](https://r.mariadb.com/join-community-slack)
59+
60+
Or reach out to us directly via:
61+
62+
* [[email protected]](mailto:[email protected])
63+
* [MariaDB Twitter](https://twitter.com/mariadb)
64+
65+
## License <a name="license"></a>
66+
[![License](https://img.shields.io/badge/License-MIT-blue.svg?style=plastic)](https://opensource.org/licenses/MIT)

‎media/demo.gif

418 KB
Loading

‎schema.sql

+9
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,9 @@
1+
CREATE DATABASE `rolodex`;
2+
3+
CREATE TABLE `rolodex`.`contacts` (
4+
`id` INT(11) NOT NULL AUTO_INCREMENT,
5+
`name` VARCHAR(100) NOT NULL,
6+
`age` INT(3) NOT NULL,
7+
`email` VARCHAR(100) NOT NULL,
8+
PRIMARY KEY (`id`)
9+
);

‎src/add.php

+80
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,80 @@
1+
<?php
2+
// Include database connection file
3+
include_once("config.php");
4+
5+
if(isset($_POST['update']))
6+
{
7+
// Retrieve record values
8+
$name = mysqli_real_escape_string($mysqli, $_POST['name']);
9+
$age = mysqli_real_escape_string($mysqli, $_POST['age']);
10+
$email = mysqli_real_escape_string($mysqli, $_POST['email']);
11+
12+
$nameErr = $ageErr = $emailErr = "";
13+
14+
// Check for empty fields
15+
if(empty($name) || empty($age) || empty($email)) {
16+
if(empty($name)) {
17+
$nameErr = "* required";
18+
}
19+
if(empty($age)) {
20+
$ageErr = "* required";
21+
}
22+
if(empty($email)) {
23+
$emailErr = "* required";
24+
}
25+
} else {
26+
// Insert new contact
27+
$stmt = $mysqli->prepare("INSERT INTO contacts (name,age,email) VALUES(?, ?, ?)");
28+
$stmt->bind_param("sis", $name, $age, $email);
29+
$stmt->execute();
30+
31+
// Redirect to home page (index.php)
32+
header("Location: index.php");
33+
}
34+
}
35+
else if (isset($_POST['cancel'])) {
36+
// Redirect to home page (index.php)
37+
header("Location: index.php");
38+
}
39+
?>
40+
<html>
41+
<head>
42+
<title>Edit Contact</title>
43+
<link rel="stylesheet" href="styles.css" />
44+
</head>
45+
<body>
46+
<form name="form1" method="post" action="add.php">
47+
<table>
48+
<tr>
49+
<td>Name</td>
50+
<td>
51+
<input type="text" name="name" value="<?php echo $name;?>">
52+
<span class="error"><?php echo $nameErr;?></span>
53+
</td>
54+
</tr>
55+
<tr>
56+
<td>Age</td>
57+
<td>
58+
<input type="text" name="age" value="<?php echo $age;?>">
59+
<span class="error"><?php echo $ageErr;?></span>
60+
</td>
61+
</tr>
62+
<tr>
63+
<td>Email</td>
64+
<td>
65+
<input type="text" name="email" value="<?php echo $email;?>">
66+
<span class="error"><?php echo $emailErr;?></span>
67+
</td>
68+
</tr>
69+
<tr>
70+
<td>
71+
<input class="cancel" type="submit" name="cancel" value="Cancel">
72+
</td>
73+
<td>
74+
<input type="submit" name="update" value="Update">
75+
</td>
76+
</tr>
77+
</table>
78+
</form>
79+
</body>
80+
</html>

‎src/config.php

+10
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,10 @@
1+
<?php
2+
// Basic connection settings
3+
$databaseHost = '<host_address>';
4+
$databaseUsername = '<user_name>';
5+
$databasePassword = '******';
6+
$databaseName = 'rolodex';
7+
8+
// Connect to the database
9+
$mysqli = mysqli_connect($databaseHost, $databaseUsername, $databasePassword, $databaseName);
10+
?>

‎src/config_skysql.php

+30
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,30 @@
1+
<?php
2+
// MariaDB SkySQL connection (example) settings
3+
$databaseHost = 'transactions-1.mdb0009999.db.skysql.net';
4+
$databasePort = '5002';
5+
$databaseUsername = '*********';
6+
$databasePassword = 'ywjBYqdc%BlGAi6Dr]9SbebPZ';
7+
$databaseName = 'rolodex';
8+
$ssl_pem = "/path/to/skysql_chain.pem";
9+
10+
$mysqli = mysqli_init();
11+
if (!$mysqli) {
12+
die('mysqli_init failed');
13+
}
14+
15+
mysqli_options($mysqli, MYSQLI_OPT_SSL_VERIFY_SERVER_CERT, false);
16+
17+
// THESE ARE FROM THE MYSQL SERVER.
18+
$mysqli->ssl_set(
19+
null,
20+
null,
21+
$ssl_pem,
22+
null,
23+
null
24+
);
25+
26+
if (!$mysqli->real_connect($databaseHost, $databaseUsername, $databasePassword, $databaseName, $databasePort, null, MYSQLI_CLIENT_SSL_DONT_VERIFY_SERVER_CERT)) {
27+
die('Connect Error (' . mysqli_connect_errno() . ') '
28+
. mysqli_connect_error());
29+
}
30+
?>

‎src/delete.php

+13
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,13 @@
1+
<?php
2+
// Include database connection file
3+
include("config.php");
4+
5+
// Retrieve [id] value from querystring parameter
6+
$id = $_GET['id'];
7+
8+
// Delete row for a specified [id]
9+
$result = mysqli_query($mysqli, "DELETE FROM contacts WHERE id=$id");
10+
11+
// Redirect to home page (index.php)
12+
header("Location:index.php");
13+
?>

‎src/edit.php

+104
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,104 @@
1+
<?php
2+
// Include database connection file
3+
include_once("config.php");
4+
5+
if(isset($_POST['update']))
6+
{
7+
// Retrieve record values
8+
$id = mysqli_real_escape_string($mysqli, $_POST['id']);
9+
$name = mysqli_real_escape_string($mysqli, $_POST['name']);
10+
$age = mysqli_real_escape_string($mysqli, $_POST['age']);
11+
$email = mysqli_real_escape_string($mysqli, $_POST['email']);
12+
13+
$nameErr = $ageErr = $emailErr = "";
14+
15+
// Check for empty fields
16+
if(empty($name) || empty($age) || empty($email)) {
17+
if(empty($name)) {
18+
$nameErr = "* required";
19+
}
20+
if(empty($age)) {
21+
$ageErr = "* required";
22+
}
23+
if(empty($email)) {
24+
$emailErr = "* required";
25+
}
26+
} else {
27+
// Execute UPDATE
28+
$result = mysqli_query($mysqli, "UPDATE contacts SET name='$name',age='$age',email='$email' WHERE id=$id");
29+
30+
$stmt = $mysqli->prepare("UPDATE contacts SET name=?, age=?, email=? WHERE id=?");
31+
$stmt->bind_param("sisi", $name, $age, $email, $id);
32+
$stmt->execute();
33+
34+
// Redirect to home page (index.php)
35+
header("Location: index.php");
36+
}
37+
}
38+
else if (isset($_POST['cancel'])) {
39+
// Redirect to home page (index.php)
40+
header("Location: index.php");
41+
}
42+
?>
43+
<?php
44+
// Retrieve id value from querystring parameter
45+
$id = $_GET['id'];
46+
47+
// Get contact by id
48+
$result = mysqli_query($mysqli, "SELECT * FROM contacts WHERE id=$id");
49+
50+
if (!$result) {
51+
printf("Error: %s\n", mysqli_error($mysqli));
52+
exit();
53+
}
54+
else {
55+
while($res = mysqli_fetch_array($result))
56+
{
57+
$name = $res['name'];
58+
$age = $res['age'];
59+
$email = $res['email'];
60+
}
61+
}
62+
?>
63+
<html>
64+
<head>
65+
<title>Edit Contact</title>
66+
<link rel="stylesheet" href="styles.css" />
67+
</head>
68+
<body>
69+
<form name="form1" method="post" action="edit.php?id=<?php echo $id ?>">
70+
<table>
71+
<tr>
72+
<td>Name</td>
73+
<td>
74+
<input type="text" name="name" value="<?php echo $name;?>">
75+
<span class="error"><?php echo $nameErr;?></span>
76+
</td>
77+
</tr>
78+
<tr>
79+
<td>Age</td>
80+
<td>
81+
<input type="text" name="age" value="<?php echo $age;?>">
82+
<span class="error"><?php echo $ageErr;?></span>
83+
</td>
84+
</tr>
85+
<tr>
86+
<td>Email</td>
87+
<td>
88+
<input type="text" name="email" value="<?php echo $email;?>">
89+
<span class="error"><?php echo $emailErr;?></span>
90+
</td>
91+
</tr>
92+
<tr>
93+
<td>
94+
<input class="cancel" type="submit" name="cancel" value="Cancel">
95+
</td>
96+
<td>
97+
<input type="submit" name="update" value="Update">
98+
<input type="hidden" name="id" value=<?php echo $_GET['id'];?>>
99+
</td>
100+
</tr>
101+
</table>
102+
</form>
103+
</body>
104+
</html>

‎src/index.php

+33
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,33 @@
1+
<?php
2+
// Include the database connection file
3+
include_once("config.php");
4+
5+
// Fetch contacts (in descending order)
6+
$result = mysqli_query($mysqli, "SELECT * FROM contacts ORDER BY id DESC");
7+
?>
8+
<html>
9+
<head>
10+
<title>MariaDB Rolodex</title>
11+
<link rel="stylesheet" href="styles.css" />
12+
</head>
13+
<body>
14+
<table>
15+
<tr>
16+
<td>Name</td>
17+
<td>Age</td>
18+
<td>Email</td>
19+
<td><a class="button" href="add.php">Add Contact</a></td>
20+
</tr>
21+
<?php
22+
// Print contacts
23+
while($res = mysqli_fetch_array($result)) {
24+
echo "<tr>";
25+
echo "<td>".$res['name']."</td>";
26+
echo "<td>".$res['age']."</td>";
27+
echo "<td>".$res['email']."</td>";
28+
echo "<td><a href=\"edit.php?id=$res[id]\">Edit</a> | <a href=\"delete.php?id=$res[id]\" onClick=\"return confirm('Are you sure you want to delete this contact?')\">Delete</a></td>";
29+
}
30+
?>
31+
</table>
32+
</body>
33+
</html>

0 commit comments

Comments
 (0)