Laravel10 の履歴(No.9)

创建新的Laravel10项目（Windows系统）
API开发

创建新的Laravel10项目（Windows系统）†

安装必要的组件

1. 安装php

从这里下载Windows版的php，注意Laravel10只支持8.1或8.2，用8.3或更新的版本会出问题。下载后解压到指定目录就行，并把目录加入到环境变量Path内。
https://windows.php.net/download/

2. 安装composer

从这里下载composer在Windows上的安装程序，按照提示一步步安装就行，安装完后同样把安装路径加入到环境变量Path内。
https://getcomposer.org/Composer-Setup.exe

3. mysql数据库

可用已有的，也可现安装在本地并做好配置。

环境配置

打开php目录下的php.ini文件，把以下3个选项前的注释符号去掉。

即：

;extension=fileinfo
;extension=mysqli
;extension=pdo_mysql

改为：

extension=fileinfo
extension=mysqli
extension=pdo_mysql

创建项目

命令行进入到准备创建项目的路径下，在此执行语句。

composer create-project "laravel/laravel:^10.0" example-app

等待执行完毕，就创建了以“example-app”为名称的项目，可换成别的项目名称。

数据库配置

1. 打开刚才创建项目目录内的.env文件，注意以下关于数据库的配置，将其改成自己的数据库配置：

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=laravel
DB_USERNAME=root
DB_PASSWORD=

2. 命令行进入项目目录内，执行语句创建项目所需的数据表。

php artisan migrate

运行项目

在此只给出默认的方法。命令行进入项目目录内，执行运行项目的指令。

php artisan serve

浏览器内输入默认的访问地址，即可出现该项目的界面。

http://127.0.0.1:8000/

↑

API开发†

1.1 获取Token

/ec-cube/entry_get_token
方式：GET
参数：
   id：获取Token的id，用于登录的是authenticate，用于购物车的是_token
返回结果：
   {"id":"id值","value":"Token值"}

1.2 学生（顾客）登录EC-Cube

/ec-cube/mypage/login
方式：POST
参数：
   login_email：登录邮箱地址
   login_pass：登录密码明文
   login_memory：是否保存登录状态，等于1即保留
   _csrf_token：登录Token，需要用获取Token的接口拿到Token并赋值
返回结果：
   跳转到EC-Cube首页

1.3 给EC-Cube的数据模型添加属性

前提：
   已在数据表内加入所需的字段，同时在数据模型类中加入对应的属性和setter/getter
在EC-Cube的目录内执行以下指令：
   php bin/console cache:clear
   php bin/console doctrine:cache:clear-metadata
   php bin/console doctrine:schema:update --dump-sql
   php bin/console doctrine:schema:update --force
注：如果报内存不足的异常，请把php.ini内的memory_limit属性调大
之后新加入的属性就全部生效了

1.4 注册新的学生（顾客）

/ec-cube/entry_auto_reg
方式：POST
参数：
   email：注册邮箱，以后需要用邮箱登录
   password：密码明文
   name01：姓
   name02：名
   kana01：姓的假名拼写
   kana02：名的假名拼写
   postal_code：邮政编码
   addr01：地址区域部分
   addr02：地址剩余部分，详细到门牌号等
   phone_number：电话号码
   sex：性别编码
   job：工作编码
   country：国家编码
   pref：省份编码
   skypeid：备用
   email_received_text：备用
   topimage：备用
   trialclass：备用
   beginner_class：备用
   middle_class：备用
   high_class：备用
返回结果：
   跳转到EC-Cube的注册成功页面，以后就能用这个账号来登录了

1.5 注册信息字典

都是返回JSON数组，都是同样的数据格式：[{"id":1,"name":"...","sortNo":0},{"id":2,"name":"...","sortNo":1},...]，方式都是GET，无参数，一次返回全部数据。

1.5.1 性别
```
/ec-cube/entry_dict/sexes
```

1.5.2 职业
```
/ec-cube/entry_dict/jobs
```

1.5.3 国家
```
/ec-cube/entry_dict/countries
```

1.5.4 都道府县
```
/ec-cube/entry_dict/prefs
```

1.6 教师（商家）登录EC-Cube

/ec-cube/%eccube_admin_route%/login
方式：POST
参数：
   login_email：登录用户名
   login_pass：登录密码明文
   _csrf_token：登录Token，需要用获取Token的接口拿到Token并赋值
返回结果：
   跳转到EC-Cube控制台页面
注：%eccube_admin_route%是指EC-Cube的管理路由路径，需在安装时设置EC-Cube的管理员账号时设置，设定后就保持不变。

1.7 注册新的教师（商家）

/ec-cube/entry_member_auto_reg
方式：POST
参数：
   login_id：登录名
   password：密码明文
   name：姓名
   department：店名
   skypeid：备用
   email_received_text：备用
   topimage：备用
   point：备用
   gakureki：备用
   syokureki：备用
   appeal：备用
   trialclass：备用
   beginner_class：备用
   middle_class：备用
   high_class：备用
返回结果：
   跳转到EC-Cube的注册成功页面，以后就能用这个账号来登录了

1.8 班级信息管理

1.8.1 创建新班级

/api/classinfo/
方式：POST
参数：
  {
    teacher_id: 教师ID,
    product_id: 产品ID,
    class_type: 班级类型,
    start_date: "开课日期，格式：yyyy-MM-dd",
    end_date: "结课日期，格式：yyyy-MM-dd",
    start_time: "上课时间，格式：HH:mm",
    end_time: "下课时间，格式：HH:mm",
    remarks: "备注"
  }
返回结果：
  如成功，输出刚才录入的数据并包含主键id

1.8.2 浏览全部班级信息

/api/classinfo/
方式：GET
参数：无
返回结果：
  [{"id":2,"teacher_id":1,"product_id":1,"class_type":1,"start_date":"2025-10-21","end_date":"2025-10-28","start_time":"09:00:00","end_time":"18:00:00","remarks":"--","created_at":"2025-10-21T07:16:59.000000Z","updated_at":"2025-10-21T07:45:34.000000Z"},{"id":3,"teacher_id":3,"product_id":3,"class_type":3,"start_date":"2025-10-22","end_date":"2025-10-29","start_time":"10:00:00","end_time":"19:00:00","remarks":"---","created_at":"2025-10-21T08:08:27.000000Z","updated_at":"2025-10-21T08:08:27.000000Z"}]

1.8.3 浏览单条班级信息

/api/classinfo/$id
方式：GET
参数：
  $id：班级ID
返回结果：
  {"id":2,"teacher_id":1,"product_id":1,"class_type":1,"start_date":"2025-10-21","end_date":"2025-10-28","start_time":"09:00:00","end_time":"18:00:00","remarks":"--","created_at":"2025-10-21T07:16:59.000000Z","updated_at":"2025-10-21T07:45:34.000000Z"}

1.8.4 修改班级信息

/api/classinfo/$id
方式：PUT
参数：
  $id：待修改的班级ID
  {
    teacher_id: 教师ID,
    product_id: 产品ID,
    class_type: 班级类型,
    start_date: "开课日期，格式：yyyy-MM-dd",
    end_date: "结课日期，格式：yyyy-MM-dd",
    start_time: "上课时间，格式：HH:mm",
    end_time: "下课时间，格式：HH:mm",
    remarks: "备注"
  }
返回结果：
  如成功，返回修改后的数据。

1.8.5 删除班级信息

/api/classinfo/$id
方式：DELETE
参数：
  $id：待删除的班级ID
返回结果：
  无

1.9 创建班级和商品信息

跟以上不同的是，该接口会同时在班级表和对应的EC-Cube表内写入数据。
/api/productClass
方式：POST
参数：
  {
    "name": "课程名称",
    "description_detail": "课程简介信息",
    "price": 价格,
    "currency_code": "货币符号，如：JPY（日元）",
    "start_date": "开课日期，格式：yyyy-MM-dd",
    "end_date": "结课日期，格式：yyyy-MM-dd",
    "start_time": "上课时间，格式：HH:mm",
    "end_time": "下课时间，格式：HH:mm",
    "class_type": 班级类型,
    "remarks": "备注"
  }
返回结果：
  如成功，返回生成的班级数据