Belajar membina API dengan PHP dan GraphQL

Dengan perkembangan teknologi Internet, seni bina pemisahan bahagian hadapan dan belakang telah menjadi arus perdana pembangunan Web. Dalam seni bina di mana hujung depan dan belakang dipisahkan, API ialah jambatan penting yang menghubungkan hujung depan dan belakang. Apabila membina API, PHP dan GraphQL, sebagai dua rangka kerja teknologi popular, disukai secara meluas oleh pembangun. Artikel ini akan memperkenalkan cara membina API menggunakan PHP dan GraphQL.

1. PHP membina API

PHP ialah bahasa skrip sumber terbuka yang digunakan secara meluas dalam pembangunan web meliputi pembangunan laman web, aplikasi pangkalan data, pemprosesan log, pemprosesan imej dan aspek lain. Apabila membina API, PHP boleh digunakan sebagai bahasa back-end untuk menghantar data ke front-end dengan berinteraksi dengan front-end.

1. Pasang PHP

Mula-mula, kita perlu memasang persekitaran PHP. Anda boleh menyemak sama ada PHP telah dipasang secara setempat dengan memasukkan arahan berikut dalam tetingkap baris arahan:

php -v

Jika nombor versi PHP dipaparkan, ini bermakna persekitaran PHP telah dipasang. Jika ia tidak dipasang, anda perlu pergi ke [laman web rasmi PHP](https://www.php.net/) untuk memuat turun dan memasangnya.

2. Pilih rangka kerja

Dalam PHP, terdapat berbilang rangka kerja untuk dipilih, seperti Laravel, Symfony, Zend, dsb. Antaranya, Laravel merupakan rangka kerja yang digunakan secara meluas dalam pembangunan aplikasi web PHP. Berikut ialah langkah-langkah untuk mencipta API menggunakan rangka kerja Laravel.

3. Buat Projek

Anda boleh mencipta projek Laravel bernama "myapp" secara setempat dengan memasukkan arahan berikut dalam tetingkap baris arahan:

composer create-project laravel/laravel myapp --prefer-dist

4. Buat Pengawal

Sebelum mencipta API, anda perlu mencipta pengawal. Anda boleh mencipta pengawal dengan memasukkan arahan berikut:

php artisan make:controller MyController

Dalam MyController, anda boleh menulis kod logik perniagaan API. Contohnya, dalam MyController, anda boleh menulis kod API untuk menanyakan semua maklumat pengguna seperti berikut:

public function getAllUsers()
{
    $users = User::all(); // 查询所有用户信息
    return response()->json($users); // 返回JSON格式的用户信息
}

Antaranya, Pengguna mewakili model pengguna, yang boleh ditakrifkan melalui ORM Eloquent Laravel.

5. Penghalaan

Dalam Laravel, permintaan API boleh diproses melalui penghalaan. Anda boleh menambah penghalaan pada API yang baru anda buat dengan menggunakan kod berikut:

Route::get('/users', 'MyController@getAllUsers');

Antaranya, '/users' mewakili alamat URL permintaan dan 'MyController@getAllUsers' mewakili kaedah pengawal yang mengendalikan permintaan itu.

6. Jalankan projek

Akhir sekali, anda boleh menjalankan projek Laravel yang dibuat dengan arahan berikut:

php artisan serve

Dengan mengakses 'http://localhost : 8000/pengguna' untuk melihat data format JSON bagi semua maklumat pengguna.

2. API pembinaan GraphQL

Berbanding dengan API RESTful, kelebihan GraphQL ialah ia membolehkan bahagian hadapan memulakan pertanyaan yang tepat untuk mendapatkan data yang diperlukan, mengurangkan tekanan pertanyaan pangkalan data . Di bawah ini kami memperkenalkan cara menggunakan GraphQL untuk membina API.

1. Pasang GraphQL

GraphQL boleh dimulakan sebagai perkhidmatan API bebas, jadi ia perlu dipasang terlebih dahulu. GraphQL boleh dipasang melalui arahan berikut:

npm install graphql-yoga

2. Buat Skema

Dalam GraphQL, anda perlu menulis Skema untuk mentakrifkan antara muka API. Skema menerangkan jenis setiap jenis data, jenis pulangan setiap medan, dan parameter input dan output kaedah. Sebagai contoh, dalam Skema ini, kita perlu menentukan jenis Pengguna dan antara muka untuk menanyakan semua maklumat pengguna. Kodnya adalah seperti berikut:

const typeDefs = `
  type User {
    id: ID!
    name: String!
    email: String
  }
  type Query {
    getAllUsers: [User]!
  }
`;

3. Tulis Penyelesai

Penyelesai melaksanakan setiap medan dalam Skema dan menerangkan cara mendapatkan data. Dalam contoh ini, kod Penyelesai untuk menanyakan semua maklumat pengguna adalah seperti berikut:

const resolvers = {
  Query: {
    getAllUsers: async () => {
      const users = await User.find();
      return users;
    },
  },
};

4. Jalankan projek

Akhir sekali, jalankan perkhidmatan GraphQL Anda boleh memulakan perkhidmatan dengan arahan berikut :

const { GraphQLServer } = require('graphql-yoga');

const server = new GraphQLServer({ typeDefs, resolvers });
server.start({ port: 4000 }, () =>
  console.log(`Server is running on localhost:4000`)
);

Dengan mengakses 'http://localhost:4000/graphql', anda boleh menggunakan alat GraphQL Playground untuk menguji API.

Kesimpulan

Artikel ini menerangkan cara membina API menggunakan PHP dan GraphQL. Dalam PHP, anda boleh menggunakan rangka kerja Laravel untuk mencipta API, dan dalam GraphQL, anda boleh menggunakan graphql-yoga. Dengan mengkaji kandungan artikel ini, saya percaya bahawa pembaca mempunyai pemahaman tertentu tentang cara menggunakan PHP dan GraphQL untuk membina API, dan boleh cuba menerapkannya dalam projek sebenar.

Atas ialah kandungan terperinci Belajar membina API dengan PHP dan GraphQL. Untuk maklumat lanjut, sila ikut artikel berkaitan lain di laman web China PHP!