欢迎您访问程序员文章站本站旨在为大家提供分享程序员计算机编程知识!
您现在的位置是: 首页  >  IT编程

使用AngularJS和PHP的Laravel实现单页评论的方法

程序员文章站 2022-09-07 10:25:29
完整代码:https://github.com/scotch-io/laravel-angular-comment-app 目前,laravel和angular均已经成为...

完整代码:https://github.com/scotch-io/laravel-angular-comment-app

目前,laravel和angular均已经成为了web发展世界里非常著名的工具。laravel以给php社区引入的伟大内容著称,angular以其惊人的前端工具及简单著称。组合这两大框架似乎是合乎逻辑的下一步。

在我们的使用环境下,我们将使用laravel作为后端的restful api,angular作为前端,以创建一个简单的单页的评论应用。

下面是一个简单的例子,展示了如何开始使用这两种技术,所以不用害怕什么额外的数据库性的东西、如何处理子评论什么的。

我们将创建什么

这将是一个简单的单页评论应用程序:

  •     restful laravel api处理获取、创建和删除评论;
  •     angular前端负责显示我们创建的表单和评论;
  •     能够新建评论并把它添加到我们的w/o页面刷新列表;
  •     能够删除评论并把它从w/o页面刷新列表移除。

总体上,这些都是非常简单的概念。我们重点是关注laravel与angular如何一起协作的错综复杂关系。

使用AngularJS和PHP的Laravel实现单页评论的方法

laravel后端
设置laravel

继续设置好你的laravel,我们将做一些基础工作使我们的后端实现评论的增删改查:

  •     创建一个数据库迁移
  •     将样本评论植入数据库
  •     为我们的api创建路由表
  •     创建一个“全部获取”路由表让angular出来路由
  •     为评论创建一个资源控制器

准备数据库迁移

我们要一个简单的、存储评论的结构体,只需要包括内容和作者。让我们创建laravel迁移来创建评论。

我们来运行artisan命令创建评论迁移,这样就可以在我们的数据库里建立评论表:

  php artisan migrate:make create_comments_table --create=comments

我们将使用laravel模式构建器创建所需的“内容”和“作者”域。laravel也会创建id和timestamps列,这样我们可以知道这条评论是什么时候添加的。以下是评论表的代码:
 

// app/database/migrations/####_##_##_######_create_comments_table.php
...
 
  /**
   * run the migrations.
   *
   * @return void
   */
  public function up()
  {
    schema::create('comments', function(blueprint $table)
    {
      $table->increments('id');
 
      $table->string('text');
      $table->string('author');
 
      $table->timestamps();
    });
  }
...

确定你在“app/config/database.php”文件中用正确的凭证调整了数据库设置。现在我们运行迁移,这样就能用所需的列创建这张表:

  php artisan migrate

使用AngularJS和PHP的Laravel实现单页评论的方法

   评论模型

我们将用laravel eloquent模型与数据库进行交互。这很容易做到,让我们来创建一个模型:“app/models/comment.php”:
 

<?php
 
// app/models/comment.php
 
class comment extends eloquent {
    // let eloquent know that these attributes will be available for mass assignment
  protected $fillable = array('author', 'text'); 
}

现在有了表和模型,让我们通过laravel seeding向表中添加一个样本数据。
播种数据库

我们需要一些评论来测试几件事。让我们创建一个种子文件并插入三个样本评论到数据库。

创建一个文件:“app/database/seeds/commenttableseeder.php”,并添加以下代码:
 

<?php
// app/database/seeds/commenttableseeder.php
 
class commenttableseeder extends seeder 
{
 
  public function run()
  {
    db::table('comments')->delete();
 
    comment::create(array(
      'author' => 'chris sevilleja',
      'text' => 'look i am a test comment.'
    ));
 
    comment::create(array(
      'author' => 'nick cerminara',
      'text' => 'this is going to be super crazy.'
    ));
 
    comment::create(array(
      'author' => 'holly lloyd',
      'text' => 'i am a master of laravel and angular.'
    ));
  }
 
}

要调用这个播种机文件,我们要修改“app/database/seeds/databaseseeder.php”并添加以下代码:
 

  // app/database/seeds/databaseseeder.php
...
 
  /**
   * run the database seeds.
   *
   * @return void
   */
  public function run()
  {
    eloquent::unguard();
 
    $this->call('commenttableseeder');
    $this->command->info('comment table seeded.');
  }
 
...

现在我们通过artisan命令来运行我们的播种机。

 php artisan db:seed

使用AngularJS和PHP的Laravel实现单页评论的方法

  现在我们拥有一个包含评论表的数据库、一个eloquent模型和一些数据库样本。一天的工作还不算糟。。。但我们还远没有结束。

评论资源控制器(app/controllers/commentcontroller.php)

我们将使用laravel资源控制器处理评论的api函数。因为使用angular显示一个资源以及创建和更新表单,在没有创建和编辑函数的情况下,我们将通过artisan命令创建一个资源控制器。

让我们用artisan创建资源控制器。

  php artisan controller:make commentcontroller --only=index,store,destroy

对于示例应用,我们只会在资源控制器中使用这三个函数。为了扩展,你要包含所有的诸如更新、显示等函数,来实现一个更成熟的应用。

使用AngularJS和PHP的Laravel实现单页评论的方法

我们已经创建了控制器,就不需要创建和编辑函数啦,因为angular,而不是laravel会处理显示表单的工作。laravel只负责把数据返回给前端。只为了想让事情简单化,我们也从实例应用提出了更新函数。我们将处理创建、显示和删除评论。


要回传数据,我们想以json形式返回数据。我们来浏览一下新建的控制器并添加相应的函数。
 

<?php
// app/controllers/commentcontroller.php
 
class commentcontroller extends \basecontroller {
 
  /**
   * send back all comments as json
   *
   * @return response
   */
  public function index()
  {
    return response::json(comment::get());
  }
 
  /**
   * store a newly created resource in storage.
   *
   * @return response
   */
  public function store()
  {
    comment::create(array(
      'author' => input::get('author'),
      'text' => input::get('text')
    ));
 
    return response::json(array('success' => true));
  }
 
  /**
   * remove the specified resource from storage.
   *
   * @param int $id
   * @return response
   */
  public function destroy($id)
  {
    comment::destroy($id);
 
    return response::json(array('success' => true));
  }
 
}

你可以看到用laravel和eloquent处理增删改查多么容易。处理我们所需的函数简直难以置信的简单。

随着控制器的准备完成,我们后端最后要做的一件事就是路由。

我们的路由表(app/routes.php)

随着数据库的准备就绪,我们来处理laravel应用的路由表吧。既然它有自己的路由,我们将会用到路由表发送数据给前端。我们也要给后台api提供路由表,从而可以让人访问我们的评论数据。

让我们创建angular指向路由表。我们需要一个主页路由表和一个发送用户给angular的“全部获取”路由表。这保证了用户无论怎样都能访问我们的网站,它们会被路由到angular前端。

我们将以...(请击鼓)...api作为api路由表前缀。通过这种方式,如果有人想获取所有的评论,他们将使用url:http://example.com/api/comments 。这只是有意义的前进和一些基础api创建的好策略。
 

<?php
// app/routes.php
 
// =============================================
// home page ===================================
// =============================================
route::get('/', function()
{
  // we dont need to use laravel blade
  // we will return a php file that will hold all of our angular content
  // see the "where to place angular files" below to see ideas on how to structure your app
  return view::make('index'); // will return app/views/index.php
});
 
// =============================================
// api routes ==================================
// =============================================
route::group(array('prefix' => 'api'), function() {
 
  // since we will be using this just for crud, we won't need create and edit
  // angular will handle both of those forms
  // this ensures that a user can't access api/create or api/edit when there's nothing there
  route::resource('comments', 'commentcontroller', 
    array('only' => array('index', 'store', 'destroy')));
});
 
// =============================================
// catch all route =============================
// =============================================
// all routes that are not home or api will be redirected to the frontend
// this allows angular to route them
app::missing(function($exception)
{
  return view::make('index');
});

我们现在有路由表来处理laravel要做的三件主要事情。


处理“全部获取”路由表:在laravel里,你可以用几种方式实现这个。通常,用以上代码并得到整个应用的“全部获取”不太理想。另一种选择是,你可以使用laravel控制器的丢失方法来获取路由表。

测试所有的路由表 让我们确保所需的路由表都有了。我们会用到artisan查看所有的路由表:

  php artisan routes

这个命令让我们看到所有的路由表以及一个自上而下的应用视图。

使用AngularJS和PHP的Laravel实现单页评论的方法

从上图我们能看到http动词和获取所有评论,获取、创建和销毁一条评论的路由表。在api路由表的顶部,可以看到一个用户如何通过主页路由表路由到angular的。

后台完成

终于!我们laravel api的后台也完成了。我们已经做了很多,但还有很多工作要做。我们已经建立并播种了数据库,创建了模型和控制器,也建好了路由表。我们来继续完成angular前端的工作。

将angular文件放在哪

我看到这个问题很多次被问到了。我到底应该把angular文件放在哪呢,还有如何使laravel和angular一起工作。
让angular来处理前端,我们需要laravel将用户导向到index.php文件。我们可以把它放在几个不同的地方。默认情况下,当你使用:

 

// app/routes.php
route::get('/', function() {
 
  return view::make('index');  
 
});

这将返回app/views/index.php。laravel默认情况下将在app/views文件夹查找。


一些人想要将angular文件和laravel 文件完全分开。他们想要让他们的整个应用程序放在public文件夹中。这样做很简单:只需要将默认的view的位置设置为public文件夹即可。可以通过修改app/config/view.php文件来完成设置。

 

// app/config/view.php
...
   
  // make laravel look in public/views for view files
  'paths' => array(__dir__.'/../../public/views'),
 
...

现在,return view::make('index') 将会查找public/views/index.php文件。你完全可以配置你想如何组织你的app。一些人认为将整个angular应用程序放在public文件夹中好处比较多,这样可以很容易的处理路由并且如果将来有需要的话,可以完全的将后端的restful api 和前端的angular区分开来。


为了angular能进行路由,那么你的部分文件需被放置在public 文件夹中,但是这已经超出了本文的范围。

让我们假设所有东西都使用默认,并且我们的主视图文件是在我们的app/ views 文件夹下,然后我们继续。

使用laravel和angular 路由 如果使用laravel和angular 路由时冲突了,会导致很多的问题。laravel将作为主路由掌控你的应用程序。angular 路由只会发生在, 当laravel路由我们的用户, 到angular主路由(index.php)这种情况。 这就是为什么我们使用laravel掌控所有的路由。laravel将处理api路由和将任意不知如何路由的请求发送到angular。然后,你可以为你的angular 应用设置所有的路由来处理出不同的视图。


前端的angular
准备我们的应用程序

我们的angular程序中的每一件事都要在public文件夹中处理。这可以有助于我们将它和后端的app文件夹中的文件很好的区分开来。

让我们看一下我们的public文件夹中的组织结构。我们创建了模块化的angular程序,因为这是最佳实践。现在,我们程序分成的各个部分很容易进行测试和处理。
 

  • - public/
  • ----- js/
  • ---------- controllers/                // where we will put our angular controllers
  • --------------- mainctrl.js
  • ---------- services/                 // angular services
  • --------------- commentservice.js
  • ---------- app.js

angular service public/js/services/commentservice.js

我们的angular service是我们通过http调用laravel api 的一个主要的位置。它非常的简明易懂,我们使用了 angular $http service.
 

// public/js/services/commentservice.js
angular.module('commentservice', [])
 
  .factory('comment', function($http) {
 
    return {
      // get all the comments
      get : function() {
        return $http.get('/api/comments');
      },
 
      // save a comment (pass in comment data)
      save : function(commentdata) {
        return $http({
          method: 'post',
          url: '/api/comments',
          headers: { 'content-type' : 'application/x-www-form-urlencoded' },
          data: $.param(commentdata)
        });
      },
 
      // destroy a comment
      destroy : function(id) {
        return $http.delete('/api/comments/' + id);
      }
    }
 
  });

这就是我们的angular service,包含了3个不同的函数。这些是我们唯一所需要的函数,因为它们将会和我们laravel中的路由api相对应。

我们的service将会返回一个promise对象。这些将会用来处理我们的控制器。这里的命名约定同样也和我们的laravel控制器保持一致。

完成了我们的angular service,让我们开始着手我们的控制器并使用它。
 
angular控制器public/js/controllers/mainctrl.js

该控制器实现了我们应用的绝大部分功能。我们在这里面创建处理提交表单和删除评论的函数。

 

// public/js/controllers/mainctrl.js
angular.module('mainctrl', [])
 
  // 在控制器中诸如comment服务
  .controller('maincontroller', function($scope, $http, comment) {
    // 持有新评论所有表单数据的对象
    $scope.commentdata = {};
 
    // 调用显示加载图标的变量
    $scope.loading = true;
 
    // 先获取所有的评论,然后绑定它们到$scope.comments对象     // 使用服务中定义的函数
    // get all comments ====================================================
    comment.get()
      .success(function(data) {
        $scope.comments = data;
        $scope.loading = false;
      });
 
    // 处理提交表单的函数
    // save a comment ======================================================
    $scope.submitcomment = function() {
      $scope.loading = true;
 
      // 保存评论。在表单间传递评论
      // 使用在服务中创建的函数
      comment.save($scope.commentdata)
        .success(function(data) {
 
          // 如果成功,我们需要刷新评论列表
          comment.get()
            .success(function(getdata) {
              $scope.comments = getdata;
              $scope.loading = false;
            });
 
        })
        .error(function(data) {
          console.log(data);
        });
    };
 
    // 处理删除评论的函数
    // delete a comment ====================================================
    $scope.deletecomment = function(id) {
      $scope.loading = true; 
 
      // 使用在服务中创建的函数
      comment.destroy(id)
        .success(function(data) {
 
          // 如果成功,我们需要刷新评论列表
          comment.get()
            .success(function(getdata) {
              $scope.comments = getdata;
              $scope.loading = false;
            });
 
        });
    };
 
  });

正如你在控制器中看到的,我们已经注入了comment服务并使用它来实现主要的功能:获得,保存以及删除。使用这样的服务避免用$http get或put来污染我们的控制器。

连接到我们的应用public/js/app.js

在angular方面,我们已经创建了服务和控制器。现在让我们将一起连接起来,这样我们可以使用ng-app和ng-controller将它应用到我们的应用中。

这就是创建angular应用的代码。我们将把服务和控制器注入。这是最佳实践的做法,这能够使我们的应用程序模块化,且各个不同部分都是可测可扩展的。
 

// public/js/app.js
var commentapp = angular.module('commentapp', ['mainctrl', 'commentservice']);

就这样,没有太多工作。现在我们切实实现了我们的观点,我们可以看angular的各部分是如何一起工作的。

我们的主视图app/views/index.php

到目前为止,在做完一切准备工作后,我们仍然不能从浏览器中看到任何内容。因为laravel控制着我们的主路由,我们需要定义我们的视图文件,且将所有路由请求返回return view::make('index');。

让我们先创建视图。我们将使用我们已创建的所有angular内容。我们已已使用angular创建的主要部分将是我们将在index.php中主要使用的部件:

  •     ng-app和ng-controller:通过将它们附加到body标签上来应用它们
  •     ng-repeat:通过循环将评论显示到模板中
  •     submitcomment():使用ng-submit将这个函数附加到表单上
  •     loading icons:我们将创建一个称作loading的变量。如果它被设为true,我们将显示一个加载图标并隐藏评论
  •     deletecomment():我们将附加这个函数到一个删除链接,以便我们删除评论

现在让我们来写实现我们观点的实际代码。我们将对主要重要的部分做注释,这样我们就能够看到一切是如何正常工作的。

 

<!-- app/views/index.php -->
<!doctype html>
<html>
<head>
  <meta charset="utf-8">
  <title>laravel and angular comment system</title>
 
  <!-- css -->
  <link rel="stylesheet" href="//netdna.bootstrapcdn.com/bootstrap/3.1.0/css/bootstrap.min.css"> <!-- load bootstrap via cdn -->
  <link rel="stylesheet" href="//netdna.bootstrapcdn.com/font-awesome/4.0.3/css/font-awesome.min.css"> <!-- load fontawesome -->
  <style>
    body     { padding-top:30px; }
    form     { padding-bottom:20px; }
    .comment   { padding-bottom:20px; }
  </style>
 
  <!-- js -->
  <script src="//ajax.googleapis.com/ajax/libs/jquery/2.0.3/jquery.min.js"></script>
  <script src="//ajax.googleapis.com/ajax/libs/angularjs/1.2.8/angular.min.js"></script> <!-- load angular -->
 
  <!-- angular -->
  <!-- all angular resources will be loaded from the /public folder -->
    <script src="js/controllers/mainctrl.js"></script> <!-- load our controller -->
    <script src="js/services/commentservice.js"></script> <!-- load our service -->
    <script src="js/app.js"></script> <!-- load our application -->
 
</head>
<!-- declare our angular app and controller -->
<body ng-app="commentapp" ng-controller="maincontroller">
<div class="col-md-8 col-md-offset-2">
 
  <!-- page title =============================================== -->
  <div>
    <h2>laravel and angular single page application</h2>
    <h4>commenting system</h4>
  </div>
 
  <!-- new comment form =============================================== -->
  <form ng-submit="submitcomment()"> <!-- ng-submit will disable the default form action and use our function -->
 
    <!-- author -->
    <div>
      <input type="text" class="form-control input-sm" name="author" ng-model="commentdata.author" placeholder="name">
    </div>
 
    <!-- comment text -->
    <div>
      <input type="text" class="form-control input-lg" name="comment" ng-model="commentdata.text" placeholder="say what you have to say">
    </div>
     
    <!-- submit button -->
    <div class="form-group text-right">  
      <button type="submit" class="btn btn-primary btn-lg">submit</button>
    </div>
  </form>
 
  <!-- loading icon =============================================== -->
  <!-- show loading icon if the loading variable is set to true -->
  <p ng-show="loading"><span class="fa fa-meh-o fa-5x fa-spin"></span></p>
 
  <!-- the comments =============================================== -->
  <!-- hide these comments if the loading variable is true -->
  <div ng-hide="loading" ng-repeat="comment in comments">
    <h3>comment #{{ comment.id }} <small>by {{ comment.author }}</h3>
    <p>{{ comment.text }}</p>
 
    <p><a href="#" ng-click="deletecomment(comment.id)">delete</a></p>
  </div>
 
</div>
</body>
</html>

使用AngularJS和PHP的Laravel实现单页评论的方法

现在我们终于实现了我们的观点,将所有已创造的部分组合了起来。你可以去试玩一下这个应用。所有部件都应很好地结合在一起,评论的创建和删除也应该不用刷新页面。

测试

确保你测试了 github repo 的应用.下面是做好这一过程的步骤

  •     复制 repo:git clone git@github.com:scotch-io/laravel-angular-comment-app
  •     安装laravel:composer install --prefer-dist
  •     修改数据库连接 inapp/config/database.php
  •     数据迁移 database:php artisan migrate
  •     打好种子 database:php artisan db:seed
  •     浏览你的应用!

结论

以往本文在介绍使用 laravel 和angular上为你提供了帮助. 你可以在此基础上创建使用更多api的 laravel 应用, 甚至创建自己的 angular routing .