To create a RESTful API with PHP, set up your environment, understand HTTP methods, design clean endpoints, and handle data formats properly. 1. Set up PHP with a web server like Apache and install a database if needed. Use tools like Postman for testing and optionally use frameworks like Slim. 2. Use HTTP methods correctly: GET to retrieve, POST to create, PUT to update, and DELETE to remove data, returning proper status codes. 3. Design logical URLs that represent resources clearly, such as /api/users or /api/users/123, and use query parameters for filtering. 4. Use JSON for data exchange using json_encode() and json_decode(), read input via php://input, and set the Content-Type header to application/json.

Creating RESTful APIs with PHP is straightforward once you understand the basics of HTTP methods and how to structure your endpoints. The key is to map each API endpoint to a specific resource and handle it using PHP scripts that respond appropriately to GET, POST, PUT, DELETE, and other HTTP verbs.

1. Set Up Your Basic Environment

Before writing any API logic, make sure your environment supports PHP and that you have a web server running (like Apache or Nginx). You can use XAMPP, WAMP, or MAMP for local development.

Here’s what you need:

• A working PHP installation
• A database if needed (e.g., MySQL)
• A way to send HTTP requests (Postman or curl works well)

You don’t necessarily need a framework to create a REST API in PHP, but tools like Slim or Lumen can simplify routing and request handling.

Tip: Always enable mod_rewrite if you're using Apache and plan to use clean URLs.

2. Understand and Use HTTP Methods Properly

REST APIs rely heavily on standard HTTP methods:

• GET – Retrieve data
• POST – Create new data
• PUT – Update existing data
• DELETE – Remove data

In PHP, you can detect the request method using $_SERVER['REQUEST_METHOD']. For example:

$method = $_SERVER['REQUEST_METHOD'];
if ($method === 'GET') {
    // Handle GET request
}

If you’re building an API that interacts with a database, each method should correspond to a CRUD operation:

• GET → Read
• POST → Create
• PUT → Update
• DELETE → Delete

Make sure to return proper HTTP status codes like 200 (OK), 404 (Not Found), or 500 (Internal Server Error) depending on the result of the operation.

3. Design Clean and Logical Endpoints

A good REST API uses clear, logical URLs that represent resources. For example:

• /api/users – List all users
• /api/users/123 – Get user with ID 123
• /api/users (POST) – Create a new user

Use query parameters for filtering or sorting:

• /api/users?role=admin
• /api/posts?sort=date&order=desc

Parsing the URL path in plain PHP can be done using $_SERVER['REQUEST_URI'] and splitting it into parts. If you want more flexibility, consider using a router or .htaccess rewrite rules to pass all requests to a single entry point.

4. Handle Data Formats (JSON Preferred)

Most modern APIs use JSON as the data format. In PHP, you can easily encode and decode JSON using built-in functions:

• json_encode() – Convert PHP array/object to JSON string
• json_decode() – Convert JSON string to PHP object/array

When receiving input from the client (like POST or PUT data), read from php://input instead of $_POST, especially when dealing with JSON payloads:

$data = json_decode(file_get_contents('php://input'), true);

Always set the correct content-type header:

header('Content-Type: application/json');

This ensures clients know how to interpret the response.

That's basically it — structure your endpoints around resources, use HTTP methods correctly, and format your responses properly. It’s not complicated, but getting the details right makes your API easier to use and maintain.

The above is the detailed content of How do I create RESTful APIs using PHP?. For more information, please follow other related articles on the PHP Chinese website!