Heim > Artikel > php教程 > 如何用PHP/MySQL为 iOS App 写一个简单的web服务器（译） PART1

如何用PHP/MySQL为 iOS App 写一个简单的web服务器（译） PART1

WBOYOriginal: 2016-06-06 09:51:051086Durchsuche

原文：http://www.raywenderlich.com/2941/how-to-write-a-simple-phpmysql-web-service-for-an-ios-app

　　作为一个iPhone/iPad开发者，能够自己写一个简单的web服务器将是很有用的。

　　例如，你可能希望在软件启动时显示一些来自服务器的更新，或者在服务器端保存一些用户数据。除了你的想象力，没有什么能限制你了。

　　在第一篇中，我们将会一步一步的建立一个web服务器，基于promo code system（促销码系统），我在我的第一个软件中使用的，Wild Fables.在第二篇中，我们将会写一个iOS App来和它进行交互。

为了完成这个教程，你将需要一个web服务器，并装有MySQL和PHP。如果你没有，那么你有以下几种选择：

如果你想在你的Mac（free）上运行Apache/MySQL/PHP，有很多教程可以帮你。这里有一个教程。
如果你想租一个服务器（需要花钱），这里有一个教程。
或者你很懒，以上两种你都不想做，那么你可以使用我在本教程PART2做的服务器。

你不需要有PHP和MySQL的经验（当然有更好）因为这个教程包含了所有你需要的代码。

你将做什么

也许你已经知道了，如果为你的App添加了内购功能，苹果并没有提供内置的系统来提供内购的促销码。

然而，建立你自己的内购促销码将会很有用。

如果你不需要建立这个特殊的系统也没关系，你会学到怎么建立web服务器并与App交互。

建立数据库：

第一步时建立一个数据库表。这个教程你需要3个表：

rw_app:保存需要使用促销码系统的软件列表。这样，你就可以为不同的App使用相同的表

　　　　id: app的唯一标示.

　　　　app_id: app 的唯一字符串标示.

w_promo_code：保存可用促销码的表

- 　　id:唯一表示.
- 　　rw_app_id: 对应的App.
- 　　code: 用户输入的促销码字符.
- 　　unlock_code: 返回给App的促销码字符.
- 　　uses_remaining:促销码剩余可使用次数.
rw_promo_code_redeemed：保存促销码兑取后的信息。为了防止一个设备用一个促销码兑取多次。
- id: 唯一标示.
- rw_promo_code_id: 已经兑取的促销码ID (from rw_promo_code).
- device_id: 已经兑取的设备ID.
- redeemed_time: 兑取的时间.

这是建表的SQL代码：

DROP TABLE <span style="color: #0000ff;">IF</span><span style="color: #000000;"> EXISTS rw_promo_code;
DROP TABLE </span><span style="color: #0000ff;">IF</span><span style="color: #000000;"> EXISTS rw_app;
DROP TABLE </span><span style="color: #0000ff;">IF</span><span style="color: #000000;"> EXISTS rw_promo_code_redeemed;

CREATE TABLE rw_promo_code (
    id mediumint NOT </span><span style="color: #0000ff;">NULL</span> AUTO_INCREMENT PRIMARY <span style="color: #008080;">KEY</span>,<span style="color: #000000;">    
    rw_app_id tinyint NOT </span><span style="color: #0000ff;">NULL</span>,<span style="color: #000000;"> 
    code varchar(</span>255) NOT <span style="color: #0000ff;">NULL</span>,<span style="color: #000000;">
    unlock_code varchar(</span>255) NOT <span style="color: #0000ff;">NULL</span>,<span style="color: #000000;">
    uses_remaining smallint NOT </span><span style="color: #0000ff;">NULL</span><span style="color: #000000;">
);

CREATE TABLE rw_app (
    id mediumint NOT </span><span style="color: #0000ff;">NULL</span> AUTO_INCREMENT PRIMARY <span style="color: #008080;">KEY</span>,<span style="color: #000000;">    
    app_id varchar(</span>255) NOT <span style="color: #0000ff;">NULL</span><span style="color: #000000;">
);

CREATE TABLE rw_promo_code_redeemed (
    id mediumint NOT </span><span style="color: #0000ff;">NULL</span> AUTO_INCREMENT PRIMARY <span style="color: #008080;">KEY</span>,<span style="color: #000000;">    
    rw_promo_code_id mediumint NOT </span><span style="color: #0000ff;">NULL</span>,<span style="color: #000000;">
    device_id varchar(</span>255) NOT <span style="color: #0000ff;">NULL</span>,<span style="color: #000000;">
    redeemed_time TIMESTAMP </span><span style="color: #0000ff;">DEFAULT</span><span style="color: #000000;"> CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP
);</span>

在你的web服务器上，你需要建立一个MySQL数据库并建立这三张表。这里是完成的命令：

保存上面的代码到一个名为create.sql的文件，然后：

rwenderlich@kermit:~$ <span style="color: #008080;">mysql</span> -u root -<span style="color: #000000;">p
Enter password</span>:<span style="color: #000000;"> 
Welcome to the </span><span style="color: #008080;">MySQL</span> monitor.  Commands <span style="color: #008080;">end</span> with ; or \g.<span style="color: #000000;">
Your </span><span style="color: #008080;">MySQL</span> connection id is 1286<span style="color: #000000;">
Server version</span>: 5.1.37-1ubuntu5.1-<span style="color: #008080;">log</span><span style="color: #000000;"> (Ubuntu)

Type </span>'help;' or '\h' <span style="color: #0000ff;">for</span> help. Type '\c' to clear the <span style="color: #008080;">current</span> input statement.

<span style="color: #008080;">mysql</span>><span style="color: #000000;"> create database promos;
Query OK</span>, 1 row affected (0.00<span style="color: #000000;"> sec)

</span><span style="color: #008080;">mysql</span>> <span style="color: #0000ff;">use</span><span style="color: #000000;"> promos;
Database changed
</span><span style="color: #008080;">mysql</span>> grant all privileges on promos.* to 'username'@'localhost' identified by 'password'<span style="color: #000000;">;
Query OK</span>, 0 rows affected (0.00<span style="color: #000000;"> sec)

</span><span style="color: #008080;">mysql</span>> <span style="color: #0000ff;">exit</span><span style="color: #000000;">
Bye

rwenderlich@kermit</span>:~$ <span style="color: #008080;">mysql</span> -u username -p promos sql
Enter password:<span style="color: #000000;"> 
rwenderlich@kermit</span>:~$ <span style="color: #008080;">mysql</span> -u root -<span style="color: #000000;">p
Enter password</span>:<span style="color: #000000;"> 
Welcome to the </span><span style="color: #008080;">MySQL</span> monitor.  Commands <span style="color: #008080;">end</span> with ; or \g.<span style="color: #000000;">
Your </span><span style="color: #008080;">MySQL</span> connection id is 1417<span style="color: #000000;">
Server version</span>: 5.1.37-1ubuntu5.1-<span style="color: #008080;">log</span><span style="color: #000000;"> (Ubuntu)

Type </span>'help;' or '\h' <span style="color: #0000ff;">for</span> help. Type '\c' to clear the <span style="color: #008080;">current</span> input statement.

<span style="color: #008080;">mysql</span>> <span style="color: #0000ff;">use</span><span style="color: #000000;"> promos;
Database changed
</span><span style="color: #008080;">mysql</span>><span style="color: #000000;"> show tables ;
</span>+------------------------+
| Tables_in_promos       |
+------------------------+
| rw_app                 | 
| rw_promo_code          | 
| rw_promo_code_redeemed | 
+------------------------+
3 rows in set (0.00 sec)

现在已有了三张空表。下一步，建立一个测试的app：

INSERT INTO rw_app VALUES(1, 'com.razeware.test'<span style="color: #000000;">);
INSERT INTO rw_promo_code VALUES(</span>1, 1, 'test', 'com.razeware.test.unlock.cake', 10000);

好的。现在数据库已经连接，可以写PHP服务器了。

验证PHP/MySQL

在开始实现PHP服务器之前，首先检查PHP是否在你的服务器上运行正常。在你的服务器上建立一个叫promos的文件夹，在里面建立一个叫index.php的文件：

<span style="color: #000000;">php
 
</span><span style="color: #0000ff;">class</span><span style="color: #000000;"> RedeemAPI {
    </span><span style="color: #008000;">//</span><span style="color: #008000;"> Main method to redeem a code</span>
    <span style="color: #0000ff;">function</span><span style="color: #000000;"> redeem() {
        </span><span style="color: #0000ff;">echo</span> "Hello, PHP!"<span style="color: #000000;">;
    }
}
 
</span><span style="color: #008000;">//</span><span style="color: #008000;"> This is the first thing that gets called when this page is loaded
// Creates a new instance of the RedeemAPI class and calls the redeem method</span>
<span style="color: #800080;">$api</span> = <span style="color: #0000ff;">new</span><span style="color: #000000;"> RedeemAPI;
</span><span style="color: #800080;">$api</span>-><span style="color: #000000;">redeem();
 
</span>?>

你可以用你的服务器的URL测试，也可以像下面这样在命令行测试：

Ray-Wenderlichs-Mac-mini-2:~ rwenderlich$ curl http:<span style="color: #008000;">//</span><span style="color: #008000;">www.wildfables.com/promos/</span>
Hello, PHP!

下一步，扩展这个类，确保你的服务器可以连接到数据库：

<span style="color: #0000ff;">class</span><span style="color: #000000;"> RedeemAPI {
    </span><span style="color: #0000ff;">private</span> <span style="color: #800080;">$db</span><span style="color: #000000;">;
 
    </span><span style="color: #008000;">//</span><span style="color: #008000;"> Constructor - open DB connection</span>
    <span style="color: #0000ff;">function</span><span style="color: #000000;"> __construct() {
        </span><span style="color: #800080;">$this</span>->db = <span style="color: #0000ff;">new</span> mysqli('localhost', 'username', 'password', 'promos'<span style="color: #000000;">);
        </span><span style="color: #800080;">$this</span>->db->autocommit(<span style="color: #0000ff;">FALSE</span><span style="color: #000000;">);
    }
 
    </span><span style="color: #008000;">//</span><span style="color: #008000;"> Destructor - close DB connection</span>
    <span style="color: #0000ff;">function</span><span style="color: #000000;"> __destruct() {
        </span><span style="color: #800080;">$this</span>->db-><span style="color: #000000;">close();
    }
 
    </span><span style="color: #008000;">//</span><span style="color: #008000;"> Main method to redeem a code</span>
    <span style="color: #0000ff;">function</span><span style="color: #000000;"> redeem() {
        </span><span style="color: #008000;">//</span><span style="color: #008000;"> Print all codes in database</span>
        <span style="color: #800080;">$stmt</span> = <span style="color: #800080;">$this</span>->db->prepare('SELECT id, code, unlock_code, uses_remaining FROM rw_promo_code'<span style="color: #000000;">);
        </span><span style="color: #800080;">$stmt</span>-><span style="color: #000000;">execute();
        </span><span style="color: #800080;">$stmt</span>->bind_result(<span style="color: #800080;">$id</span>, <span style="color: #800080;">$code</span>, <span style="color: #800080;">$unlock_code</span>, <span style="color: #800080;">$uses_remaining</span><span style="color: #000000;">);
        </span><span style="color: #0000ff;">while</span> (<span style="color: #800080;">$stmt</span>-><span style="color: #000000;">fetch()) {
            </span><span style="color: #0000ff;">echo</span> "<span style="color: #800080;">$code</span> has <span style="color: #800080;">$uses_remaining</span> uses remaining!"<span style="color: #000000;">;
        }
        </span><span style="color: #800080;">$stmt</span>-><span style="color: #000000;">close();
    }
}</span>

这里添加了一个构造函数来连接给定用户名和密码的数据库，一个 析构函数来关闭数据库。现在你可以测试一下了：

Ray-Wenderlichs-Mac-mini-2:~ rwenderlich$ curl http:<span style="color: #008000;">//</span><span style="color: #008000;">www.wildfables.com/promos/</span>
test has 10000 uses remaining!

服务器策略：GET还是POST：

好的，现在是时候来实现完成的功能了。但首先，让我们来谈谈web服务器的策略。

我们知道我们需要向服务器发送一些数据，包括app的ID，兑换吗，要兑换的设备ID。

如何发送呢？有两种方法：GET（普通方法）和POST（用于发送表单）

如果你选择GET，那么参数是URL的一部分，就是把参数发到URL里，然后向服务器发送请求。
如果你选择POST，参数被放到request body中

每个都能满足你的需求，但是当你要尝试做些什么的时候，比如兑换促销码，还是用POST比较好。这也是我将要做的。

这是什么意思呢？如果我们想在PHP中访问这些参数，我们可以通过内建的$_POST 数组：

<span style="color: #800080;">$_POST</span>["rw_app_id"]

我们将会用ASIHTTPRequest来连接服务器，用ASIFormDataRequest类发送一个POST请求：

ASIFormDataRequest *request =<span style="color: #000000;"> [ASIFormDataRequest requestWithURL:url];
[request setPostValue:</span><span style="color: #800000;">@"</span><span style="color: #800000;">1</span><span style="color: #800000;">"</span> forKey:<span style="color: #800000;">@"</span><span style="color: #800000;">rw_app_id</span><span style="color: #800000;">"</span>];

更多GET和POST的信息，请看Wikipedia entry。

更新：请看@smpdawg’s的精彩评论forum topic

web服务器策略：算法

下一步，我们要看看将要使用的web服务器的算法：

确保需要的参数是通过POST发送的。
确保数据库里有兑换码。
确保兑换码剩余可使用次数。
确保设备没有使用过兑换码。
到这一步，就要完成了

添加一个rw_promo_code_redeemed的入口来记录兑换
将在rw_promo_code的uses_remaining减去一
返回unlock_code给App。

web服务器的实现

首先，添加一个辅助方法用于返回HTTP状态信息：

<span style="color: #008000;">//</span><span style="color: #008000;"> Helper method to get a string description for an HTTP status code
// From http://www.gen-x-design.com/archives/create-a-rest-api-with-php/ </span>
<span style="color: #0000ff;">function</span> getStatusCodeMessage(<span style="color: #800080;">$status</span><span style="color: #000000;">)
{
    </span><span style="color: #008000;">//</span><span style="color: #008000;"> these could be stored in a .ini file and loaded
    // via parse_ini_file()... however, this will suffice
    // for an example</span>
    <span style="color: #800080;">$codes</span> = <span style="color: #0000ff;">Array</span><span style="color: #000000;">(
        </span>100 => 'Continue',
        101 => 'Switching Protocols',
        200 => 'OK',
        201 => 'Created',
        202 => 'Accepted',
        203 => 'Non-Authoritative Information',
        204 => 'No Content',
        205 => 'Reset Content',
        206 => 'Partial Content',
        300 => 'Multiple Choices',
        301 => 'Moved Permanently',
        302 => 'Found',
        303 => 'See Other',
        304 => 'Not Modified',
        305 => 'Use Proxy',
        306 => '(Unused)',
        307 => 'Temporary Redirect',
        400 => 'Bad Request',
        401 => 'Unauthorized',
        402 => 'Payment Required',
        403 => 'Forbidden',
        404 => 'Not Found',
        405 => 'Method Not Allowed',
        406 => 'Not Acceptable',
        407 => 'Proxy Authentication Required',
        408 => 'Request Timeout',
        409 => 'Conflict',
        410 => 'Gone',
        411 => 'Length Required',
        412 => 'Precondition Failed',
        413 => 'Request Entity Too Large',
        414 => 'Request-URI Too Long',
        415 => 'Unsupported Media Type',
        416 => 'Requested Range Not Satisfiable',
        417 => 'Expectation Failed',
        500 => 'Internal Server Error',
        501 => 'Not Implemented',
        502 => 'Bad Gateway',
        503 => 'Service Unavailable',
        504 => 'Gateway Timeout',
        505 => 'HTTP Version Not Supported'<span style="color: #000000;">
    );
 
    </span><span style="color: #0000ff;">return</span> (<span style="color: #0000ff;">isset</span>(<span style="color: #800080;">$codes</span>[<span style="color: #800080;">$status</span>])) ? <span style="color: #800080;">$codes</span>[<span style="color: #800080;">$status</span>] : ''<span style="color: #000000;">;
}
 
</span><span style="color: #008000;">//</span><span style="color: #008000;"> Helper method to send a HTTP response code/message</span>
<span style="color: #0000ff;">function</span> sendResponse(<span style="color: #800080;">$status</span> = 200, <span style="color: #800080;">$body</span> = '', <span style="color: #800080;">$content_type</span> = 'text/html'<span style="color: #000000;">)
{
    </span><span style="color: #800080;">$status_header</span> = 'HTTP/1.1 ' . <span style="color: #800080;">$status</span> . ' ' . getStatusCodeMessage(<span style="color: #800080;">$status</span><span style="color: #000000;">);
    </span><span style="color: #008080;">header</span>(<span style="color: #800080;">$status_header</span><span style="color: #000000;">);
    </span><span style="color: #008080;">header</span>('Content-type: ' . <span style="color: #800080;">$content_type</span><span style="color: #000000;">);
    </span><span style="color: #0000ff;">echo</span> <span style="color: #800080;">$body</span><span style="color: #000000;">;
}</span>

如果你不理解为什么我们不要这个，那是因为这是一个遵守HTTP协议的web服务器，当你发送一个相应你可以制定一个包含错误码和详细描述的头。有标准错误码可以用，这些方法不过是用起来更方便。

正如你看到的，我防线了一个可以把状态吗转换成HTML信息的教程。

下一步，就是真正的实现了！

function redeem() {
 
    // Check for required parameters
    if (isset(<span style="color: #800080;">$_POST</span>["rw_app_id"]) && isset($_POST["code"]) && isset($_POST["device_id"])) {
 
        // Put parameters into local variables
        $rw_app_id = $_POST["rw_app_id"];
        $code = $_POST["code"];
        $device_id = $_POST["device_id"];
 
        // Look up code in database
        $user_id = 0;
        $stmt = $this->db->prepare('SELECT id, unlock_code, uses_remaining FROM rw_promo_code WHERE rw_app_id=? AND code=?');
        $stmt->bind_param("is", $rw_app_id, $code);
        $stmt->execute();
        $stmt->bind_result($id, $unlock_code, $uses_remaining);
        while ($stmt->fetch()) {
            break;
        }
        $stmt->close();
 
        // Bail if code doesn't exist
        if ($id ) {
            sendResponse(400, 'Invalid code');
            return false;
        }
 
        // Bail if code already used        
        if ($uses_remaining ) {
            sendResponse(403, 'Code already used');
            return false;
        }    
 
        // Check to see if this device already redeemed    
        $stmt = $this->db->prepare('SELECT id FROM rw_promo_code_redeemed WHERE device_id=? AND rw_promo_code_id=?');
        $stmt->bind_param("si", $device_id, $id);
        $stmt->execute();
        $stmt->bind_result($redeemed_id);
        while ($stmt->fetch()) {
            break;
        }
        $stmt->close();
 
        // Bail if code already redeemed
        if ($redeemed_id > 0) {
            sendResponse(403, 'Code already used');
            return false;
        }
 
        // Add tracking of redemption
        $stmt = $this->db->prepare("INSERT INTO rw_promo_code_redeemed (rw_promo_code_id, device_id) VALUES (?, ?)");
        $stmt->bind_param("is", $id, $device_id);
        $stmt->execute();
        $stmt->close();
 
        // Decrement use of code
        $this->db->query("UPDATE rw_promo_code SET uses_remaining=uses_remaining-1 WHERE id=$id");
        $this->db->commit();
 
        // Return unlock code, encoded with JSON
        $result = array(
            "unlock_code" => $unlock_code,
        );
        sendResponse(200, json_encode($result));
        return true;
    }
    sendResponse(400, 'Invalid request');
    return false;
 
}

你应该能够读懂这段代码，否则的话查看以下这个教程Mysqli reference。这里有一些事情我需要指出：

isset是一个用于检测变量是否已经设置了的PHP函数。我们这里用它来确保所有需要的POST参数都发送了。
注意我们没有自己把传进来的变量放到SQL语句中，而是使用bind_param方法。这是更安全的方法，否则你可能使自己易受SQL injection的攻击。
注意 unlock_code 用JSON返回。我们当然可以直接用字符串返回因为我们只返回一个信息，但是用JSON便于以后扩展。

现在，你的web服务器就已经可以工作了。你可以用下面命令来测试：

curl -F "rw_app_id=1" -F "code=test" -F "device_id=test" http:<span style="color: #008000;">//</span><span style="color: #008000;">www.wildfables.com/promos/</span>
{"unlock_code":"com.razeware.wildfables.unlock.test"}

注意，如果你在我的服务器上测试，如果你得到“code already used”的错误，你应该更改你的device_id。

你可能希望进入你的数据库看看那里是否有一个rw_promo_code_redeemed的入口，uses_remaining是否减一等等。

下一步？

这里是源码source code。

敬请期待PART2.

Stellungnahme：

Der Inhalt dieses Artikels wird freiwillig von Internetnutzern beigesteuert und das Urheberrecht liegt beim ursprünglichen Autor. Diese Website übernimmt keine entsprechende rechtliche Verantwortung. Wenn Sie Inhalte finden, bei denen der Verdacht eines Plagiats oder einer Rechtsverletzung besteht, wenden Sie sich bitte an admin@php.cn

Vorheriger Artikel：linux下php扩展curl的安装Nächster Artikel：PHP+MYSQL 出现乱码的解决方法

In Verbindung stehende Artikel

Mehr sehen