12天:Admin生成器

加上我们在Jobeet 11天,前端应用程序现在已经完全可用的求职者和工作的海报。是时候谈谈后端应用程序。今天,多亏了symfony的admin发生器功能,我们将开发一个完整的后端接口Jobeet在短短一个小时。ob娱乐下载

后端创建

第一步是创建后端应用程序。如果你没有记错,你应该记得的生成:应用程序任务:

美元php ob娱乐下载symfony生成:应用程序的后端

后端应用程序现在可以在http://jobeet.localhost/backend.php/为刺激环境,在http://jobeet.localhost/backend_dev.php/为dev环境。

如果您尝试重新加载数据装置推动:数据加载任务,它不会像预期的那样工作。这是因为JobeetJob:保存()需要访问的方法app.yml配置文件的前端应用程序。现在我们有两个应用程序,symfony使用第一个发现,这是现在ob娱乐下载后端一个。

但是当看到在第8天,设置可以在不同层次上配置。通过移动的内容应用程序/前端/ config / app.yml文件配置/ app.yml,设置将在所有应用程序之间共享,问题将会解决。做改变现在我们将使用在管理发电机模型类相当广泛,所以我们需要中定义的变量app.yml后端应用程序。

php syob娱乐下载mfony推动美元:数据加载——应用程序=前端

后端模块

对于前端应用程序,推动:generate-module任务被用来引导一个基本的CRUD模块基于模型类。为后端推动:generate-admin任务将被用作它生成一个完整的工作端界面模型类:

php syob娱乐下载mfony推动美元:generate-admin端JobeetJob——模块=工作php symfony推动美元:generate-admin端JobeetCategory——模块=类别

这两个命令创建一个工作和一个类别模块的JobeetJob和JobeetCategory模型类。

可选——模块选择覆盖模块任务名称生成默认的(否则jobeet_job为JobeetJob类)。

在幕后,任务也为每个模块创建一个定制的路线:

#应用/后端/ config /路由。yml jobeet_job:类:sfPropelRouteCollection选项:模型:JobeetJob模块:工作prefix_path:工作列:id with_wildcard_routes:真的

它应该不足为奇的路线管理发电机|管理发电机使用的类sfPropelRouteCollection,作为一个管理界面的主要目标是管理模型对象的生命周期。

路由定义还定义了一些选项我们没有见过的:

• prefix_path:定义的前缀路径生成的路径(例如,编辑页面将类似/ / 1 /编辑的工作)。
• 列:定义要使用的表列的URL链接引用一个对象。
• with_wildcard_routes:随着管理界面将有更多比经典的CRUD操作,这个选项允许定义更多的对象和集合行为没有编辑路线。

php syob娱乐下载mfony帮助推动美元:generate-admin

后端外观和感觉

马上,你可以使用生成的模块:

http://jobeet.localhost/backend_dev.php/工作http://jobeet.localhost/backend_dev.php/类别

管理功能模块有很多比我们在前几天有生成简单的模块。而无需编写一行PHP,每个模块提供了这些伟大的特点:

• 对象的列表分页的
• 列表可分类的
• 列表可以过滤后的
• 对象可以创建,编辑,删除
• 选定的对象可以被删除批处理
• 表单验证启用了
• Flash的消息提供即时反馈给用户
• …和许多更多

管理发电机提供的所有特性,您需要创建一个后端接口在一个简单的配置方案。

如果你看一看我们两个生成模块,您将注意到没有激活设计而symfony内置管理员默认生成器功能有一个基本的图形界面。ob娱乐下载现在,资产sfPropelPlugin坐落在吗web /文件夹中。我们需要发布下web /多亏了文件夹插件:发布资产任务:

美元php ob娱乐下载symfony插件:发布资产

一个更好的用户体验,我们需要定制默认的后端。我们还将添加一个简单的菜单,让它容易不同模块之间的导航。

替换默认布局用下面的代码文件内容:

/ /应用程序/后端/模板/ layout.php< !DOCTYPE html公共”——/ / W3C XHTML 1.0 / / DTD过渡/ / EN”“http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd”> < html xmlns =“http://www.w3.org/1999/xhtml”xml: lang =“en”lang =“en”> <头> <标题> Jobeet管理界面< /名称> < link rel =“快捷方式图标”href =“/ ico”位于/ >< ? phpuse_stylesheet(“admin.css”)? >< ? phpinclude_javascripts()? >< ? phpinclude_stylesheets()? >< /头> <身体> < div id =“容器”> < div id =“头”> < h1 > < a href =“< ?php echo url_for(主页)? > "> < img src =“遗产/图片/ logo.jpg”alt =“Jobeet工作委员会”/ > < / > < / h1 > < / div > < div id =“菜单”<李> > < ul >< ? php回声link_to(“工作”,“jobeet_job”)? ><李> < /李>< ? php回声link_to(“类别”,“jobeet_category”)? >< /李> < / ul > < / div > < div id =“内容”>< ? php回声sf_content美元? >< / div > < div id =“页脚”> < img src =“遗产/图片/ jobeet-mini.png”/ >的< a href =“/”> < img src =“遗产/图片/ symfony.ob娱乐下载gif”alt =“ob娱乐下载symfony框架”/ > < / > < / div > < / div > < /身体> < / html >

这种布局使用一个admin.css样式表。这个文件必须已经存在于web / css /因为它是安装在第四天与其他样式表。

最后,改变默认的symfony的主页ob娱乐下载routing.yml:

#应用/后端/ config /路由。yml主页:url: /参数:{模块:工作、行动:指数}

symfob娱乐下载ony缓存

如果你好奇,你有可能已经打开了任务下所生成的文件应用程序/后端/模块/目录中。如果不是,请打开。惊喜!的模板目录是空的,actions.class.php文件是相当空:

/ /应用程序/后端/模块/工作/行动/ actions.class.phprequire_once目录名(__FILE__)。“/ . . / lib / jobGeneratorConfiguration.class.php”;require_once目录名(__FILE__)。“/ . . / lib / jobGeneratorHelper.class.php”;类jobActions扩展autoJobActions{}

这怎么可能呢?如果你仔细看,你会注意到的jobActions类继承了autoJobActions。的autoJobActions类自动生成的symfony如果它不存在。ob娱乐下载它是被发现的缓存/后端/ dev /模块/ autoJob /目录,其中包含“真实”模块:

/ /缓存/后端/ dev /模块/ autoJob /行动/ actions.class.php类autoJobActions扩展sfActions{公共函数preExecute(){这个美元- >配置=新jobGeneratorConfiguration();如果(!这个美元- >getUser()- >hasCredential(这个美元- >配置- >getCredentials(这个美元- >getActionName()))){/ /……

管理发电机的工作方式应该提醒你一些已知的行为。事实上,它非常类似于我们已经了解了模型,形成类。基于模型模式定义,symfony生成模型,形成类。ob娱乐下载管理生成器,生成模块可以通过编辑配置配置/ generator.yml文件中发现的模块:

#应用/后端/模块/工作/ config /发电机。yml发生器:类:sfPropelGenerator参数:model_class: JobeetJob主题:管理non_verbose_templates:真正的with_show:虚假奇异:~复数:~ route_prefix: jobeet_job with_propel_route:真正的配置:行动:~:~列表:~过滤器:~形式:~编辑:~新:~

每次你更新generator.yml文件,symob娱乐下载fony重新生成缓存。稍后我们将看到,定制模块生成的管理很简单,快速和有趣。

- - -

后端配置

管理员模块可以通过编辑定制配置关键的generator.yml文件。配置组织7个部分:

• 行动:默认配置的行为发现名单上和形式
• 字段:默认配置字段
• 列表:配置列表
• 过滤器:配置过滤器
• 形式:新和编辑配置形式
• 编辑编辑页面:特定的配置
• 新新页面:特定的配置

让我们开始定制。

标题的配置

的列表,编辑,新节的标题类别模块可以通过定义一个自定义标题选择:

#应用/后端/模块/类别/ config /发电机。yml配置:行动:~:~列表:标题:品类管理过滤器:~形式:~编辑:标题:编辑类别“% % % %”新:标题:新类别

的标题为编辑部分包含动态值:所有字符串之间的封闭% %列值替换为相应的对象。

的配置工作模块非常相似:

#应用/后端/模块/工作/ config /发电机。yml配置:行动:~:~列表:标题:作业管理过滤器:~形式:~编辑:标题:编辑工作“% % % %公司寻找% % % %”新:标题:创造就业

字段配置

不同的观点(列表,新,编辑)是由字段组成。一个字段可以列模型的类,或一个虚拟列以后我们会看到。

默认字段配置可以定制字段部分:

#应用/后端/模块/工作/ config /发电机。yml配置:字段:is_activated:{标签:激活?,帮助:Whether the user has activated the job, or not } is_public: { label: Public?, help: Whether the job can also be published on affiliate websites, or not }

的字段部分覆盖所有视图的字段配置,这意味着标签为is_activated字段将被改变列表,编辑,新的观点。

管理发电机配置基于级联配置原则。例如,如果你想改变一个标签的列表视图,定义一个字段以下选项列表部分:

#应用/后端/模块/工作/ config /发电机。yml配置::列表字段:is_public:{标签:“公众吗?(标签列表)”}

主要下任何配置设置字段可以覆盖部分视图相关配置。最重要的规则是:

• 新和编辑继承形式它继承自字段
• 列表继承自字段
• 过滤器继承自字段

列表视图配置

显示

默认情况下,列表视图的列都是模型的列,在模式文件的顺序。的显示由定义命令列选项覆盖默认的显示:

#应用/后端/模块/类别/ config /发电机。yml配置:列表:标题:品类管理显示:[=名字,蛞蝓]

的=签署前的名字列是一个惯例将字符串转换成一个链接。

让我们做的一样工作模块,增加代码的可读性:

#应用/后端/模块/工作/ config /发电机。yml配置:列表:标题:作业管理显示:[is_activated公司、位置、位置、url,电子邮件)

布局

列表可以显示不同的布局。默认情况下,布局表格,这意味着每一列值的表列。但对于工作模块,它将是更好的使用堆放布局,这是其他内置的布局:

#应用/后端/模块/工作/ config /发电机。yml配置:列表:标题:作业管理布局:堆叠显示:[is_activated公司、位置、位置、url,电子邮件)参数:| % % is_activated % % <小> % % category_id添加% % < /小>公司- % % % % (< em > % % % % < / em >邮件)正在寻找一个% % =位置% %(% % % %位置)

在一个堆放布局,每个对象都表示为一个字符串,它定义的参数个数选择。

“虚拟”列

在这个配置中,% % category_id添加% %段将被类别取代主键。但它将是更有意义的显示类别的名称。

每当你使用% %符号,变量不需要对应于数据库模式中的一个实际的列。管理发电机只需要找到一个相关的模型类的getter。

显示类别名称,我们可以定义一个getCategoryName ()方法JobeetJob模型类和替换% % category_id添加% %通过% % category_name % %。

但是,JobeetJob类已经有一个getJobeetCategory ()方法返回对象相关的类别。如果你使用% % jobeet_category % %,它的工作原理JobeetCategory类有一个魔法__toString ()方法将对象转换为一个字符串。

#应用/后端/模块/工作/ config /发电机。yml % % is_activated % % <小> % % jobeet_category % % < /小>公司- % % % % (< em > % % % % < / em >邮件)正在寻找一个% % =位置% %(% % % %位置)

排序

作为管理员,您可能会看到最新发布的工作更感兴趣。您可以配置默认排序通过添加一个列排序选择:

#应用/后端/模块/工作/ config /发电机。yml配置:列表:排序:[expires_at, desc)

max_per_page

默认情况下,列表分页的,每个页面包含20个项目。这可以改变max_per_page选择:

#应用/后端/模块/工作/ config /发电机。yml配置:列表:max_per_page: 10

batch_actions

在一个列表,一个动作可以运行在多个对象。这些不需要批处理操作类别模块,所以,让我们删除它们:

#应用/后端/模块/类别/ config /发电机。yml配置:列表:batch_actions: {}

的batch_actions选项定义了批处理操作的列表。空数组允许删除的功能。

默认情况下,每个模块都有一个删除批处理操作定义的框架,但是工作模块,假设我们需要一种方法来扩展一些选定的工作另一个30天的有效性:

#应用/后端/模块/工作/ config /发电机。yml配置:列表:batch_actions: _delete:扩展:~ ~

所有操作的开始_提供的内置的行动框架。如果你刷新浏览器,选择扩展的批处理操作,symfony会抛出异常告诉你创建一个ob娱乐下载executeBatchExtend ()方法:

/ /应用程序/后端/模块/工作/行动/ actions.class.php类jobActions扩展autoJobActions{公共函数executeBatchExtend(sfWebRequest美元的请求){$ id=美元的请求- >getParameter(“id”);美元的工作= JobeetJobPeer::retrieveByPks($ id);foreach(美元的工作作为美元的工作){美元的工作- >扩展(真正的);}这个美元- >getUser()- >setFlash(“通知”,“选定的工作已经成功扩展。”);这个美元- >重定向(“jobeet_job”);}}

所选的主键存储在id请求参数。对于每个选定的工作,JobeetJob:扩展()方法使用一个额外的参数绕过过期支票。

更新扩展()方法来考虑这个新观点:

/ / lib /模型/ JobeetJob.php类JobeetJob扩展BaseJobeetJob{公共函数扩展(美元的力量=假){如果(!美元的力量& & !这个美元- >expiresSoon()){返回假;}这个美元- >setExpiresAt(时间()+86400年* sfConfig::得到(“app_active_days”));这个美元- >保存();返回真正的;}/ /……}

毕竟工作已经扩展,用户被重定向到工作模块的主页。

object_actions

在列表中,有一个额外的列行动可以运行在一个单独的对象。为类别模块,删除它们,因为我们有一个链接类别名称编辑它,和我们真的不需要删除一个直接从列表:

#应用/后端/模块/类别/ config /发电机。yml配置:列表:object_actions: {}

为工作模块,让我们保持现有的操作和添加一个新的扩展行动类似我们添加了一批行动:

#应用/后端/模块/工作/ config /发电机。yml配置:列表:object_actions:扩展:~ _edit: ~ _delete: ~

至于批量操作,_delete和_edit行为的定义的框架。我们需要定义listExtend ()行动使扩展联系工作:

/ /应用程序/后端/模块/工作/行动/ actions.class.php类jobActions扩展autoJobActions{公共函数executeListExtend(sfWebRequest美元的请求){美元的工作=这个美元- >getRoute()- >getObject();美元的工作- >扩展(真正的);这个美元- >getUser()- >setFlash(“通知”,“选定的工作已经成功扩展。”);这个美元- >重定向(“jobeet_job”);}/ /……}

行动

我们已经看到如何链接操作一个对象或一个对象列表。的行动选项定义了行动,没有对象,创建一个新对象。让我们删除默认新行动并添加一个新的行动,删除所有的工作没有被激活超过60天的海报:

#应用/后端/模块/工作/ config /发电机。yml配置:列表:行动:deleteNeverActivated:{标签:删除不激活工作}

直到现在,我们已经定义了所有行动~,这意味着symfony自动配置操作。ob娱乐下载每一个动作都可以定制通过定义一个参数数组。的标签选项生成的默认标签覆盖symfony。ob娱乐下载

默认情况下,这个动作当你点击链接执行行动的名称前缀列表。

创建listDeleteNeverActivated行动工作模块:

/ /应用程序/后端/模块/工作/行动/ actions.class.php类jobActions扩展autoJobActions{公共函数executeListDeleteNeverActivated(sfWebRequest美元的请求){nb美元= JobeetJobPeer::清理(60);如果(nb美元){这个美元- >getUser()- >setFlash(“通知”,sprintf(' % d从来没有激活的工作已经成功删除。,nb美元));}其他的{这个美元- >getUser()- >setFlash(“通知”,“没有删除的工作。”);}这个美元- >重定向(“jobeet_job”);}/ /……}

我们重复使用JobeetJobPeer:清理()昨天的方法定义。这是另一个很好的例子,MVC模式提供的可重用性。

deleteNeverActivated:{标签:删除不激活工作,行动:foo}

peer_method

数据库请求的数量需要显示工作列表是14页,如图所示的web调试工具栏。

如果你点击这个数字,你会发现大多数请求来检索每个工作的类别名称:

减少数量的查询,我们可以改变默认的方法用于获取工作使用peer_method选择:

#应用/后端/模块/工作/ config /发电机。yml配置:列表:peer_method: doSelectJoinJobeetCategory

的doSelectJoinJobeetCategory ()方法之间的一个连接工作和类别表和自动创建类对象相关的工作。

请求的数量现在是四个:

表格视图配置

表单视图配置在三个部分:形式,编辑,新。他们都有相同的配置和功能形式部分只存在的回退编辑和新部分。

显示

的列表,您可以更改显示字段的顺序显示选择。但显示的形式被定义为一个类,不要尝试删除一个领域,因为它可能会导致意想不到的验证错误。

的显示选择表单视图也可以用来安排字段分组:

#应用/后端/模块/工作/ config /发电机。yml配置:形式:显示:内容:[category_id添加、类型、公司标志、url位置,位置,描述,how_to_apply, is_public,电子邮件)管理:[_generated_token、is_activated expires_at]

上面的配置定义两组(内容和管理),每个片段包含表单字段的一个子集。

管理发生器内置支持许多许多关系。类别形式,您输入的名称,一个用于“鼻涕虫”,下拉框相关子公司。因为它没有意义这个页面上编辑这个关系,让我们删除它:

/ / lib /形式/ JobeetCategoryForm.class.php类JobeetCategoryForm扩展BaseJobeetCategoryForm{公共函数配置(){设置(这个美元(“jobeet_category_affiliate_list”]);}}

“虚拟”列

在显示选择的工作形式,_generated_token字段始于一个下划线(_)。这意味着呈现为这个字段将由一个定制的部分命名_generated_token.php。

创建这个部分有以下内容:

/ /应用程序/后端/模块/工作/模板/ _generated_token.php< div类=“sf_admin_form_row”> <标记>标记< /标签>< ? php回声美元的形式- >getObject()- >getToken()? >< / div >

的部分,你可以访问当前形式(美元的形式)和相关的对象是通过访问getObject ()方法。

类

的形式将由管理员,我们有比用户工作表单显示更多的信息。但是现在,他们中的一些人不出现在的形式,因为他们已被移除JobeetJobForm类。

有不同形式的前端和后端,我们需要创建两个类形式。让我们创建一个BackendJobeetJobForm类,它扩展了JobeetJobForm类。我们不会有相同的隐藏字段,我们还需要重构JobeetJobForm类移动一点设置()声明一个方法,将覆盖BackendJobeetJobForm:

/ / lib /形式/ JobeetJobForm.class.php类JobeetJobForm扩展BaseJobeetJobForm{公共函数配置(){这个美元- >removeFields();这个美元- >validatorSchema(“电子邮件”]=新sfValidatorAnd(数组(这个美元- >validatorSchema(“电子邮件”],新sfValidatorEmail(),));/ /……}受保护的函数removeFields(){设置(这个美元(“created_at”],这个美元(“updated_at”],这个美元(“expires_at”],这个美元(“is_activated”],这个美元(“令牌”]);}}/ / lib /形式/ BackendJobeetJobForm.class.php类BackendJobeetJobForm扩展JobeetJobForm{受保护的函数removeFields(){设置(这个美元(“created_at”],这个美元(“updated_at”],这个美元(“令牌”]);}}

使用的默认表单类管理发生器可以通过设置覆盖类选择:

#应用/后端/模块/工作/ config /发电机。yml配置:形式:类:BackendJobeetJobForm

的编辑形式仍有一个小烦恼。当前上传标志不出现在任何地方,您不能删除。的sfWidgetFormInputFileEditable小部件将编辑功能添加到一个简单的输入文件窗口小部件:

/ / lib /形式/ BackendJobeetJobForm.class.php类BackendJobeetJobForm扩展JobeetJobForm{公共函数配置(){父::配置();这个美元- >widgetSchema(“标志”]=新sfWidgetFormInputFileEditable(数组(“标签”= >公司标志的,“file_src”= >' /上传/工作/。这个美元- >getObject()- >getLogo(),“is_image”= >真正的,edit_mode的= > !这个美元- >isNew(),“模板”= >' < div > %文件% < br / > %输入% < br / > % % % delete_label删除% < / div > ',));这个美元- >validatorSchema(“logo_delete”]=新sfValidatorPass();}/ /……}

的sfWidgetFormInputFileEditable小部件需要几个选项来调整其特点和呈现:

• file_src:当前的上传文件的网络路径
• is_image:如果真正的,文件将会呈现为一个图像
• edit_mode:是否表单处于编辑模式
• with_delete:是否显示“删除”复选框
• 模板:呈现小部件的模板来使用

的edit_mode选择使用sfPropel: isNew ()方法。

它返回真正的如果表单的模型对象是新的,和假否则。这是很大的帮助,当你需要不同的部件或验证器根据嵌入对象的状态。

过滤器配置

配置过滤器是完全一样的配置形式的观点。事实上,过滤器只是形式。至于形式,已生成的类推动:构建——所有的任务。你也可以重新生成的推动:构建——过滤器的任务。

表单过滤器类位于下lib /过滤器/目录和每个模型类都有一个关联的滤波器形式类(JobeetJobFormFilter为JobeetJobForm)。

让我们完全的删除它们类别模块:

#应用/后端/模块/类别/ config /发电机。yml配置:过滤器:类:假的

为工作模块,让我们删除其中一些:

#应用/后端/模块/工作/ config /发电机。yml过滤器:显示:[category_id添加,公司位置,描述、is_activated is_public,电子邮件,expires_at]

作为过滤器永远是可选的,不需要覆盖过滤器形式类配置字段显示出来。

行为定制

当配置是不够的,你可以添加新的方法,action类正如我们所看到的扩展功能,但你也可以覆盖生成的操作方法:

每个生成的方法只做一件事,很容易改变行为,而无需复制粘贴太多的代码。

模板定制

我们已经看到如何定制生成的模板了类和id属性由管理员添加HTML代码生成器。

至于类,你还可以覆盖原来的模板。作为模板是纯PHP文件而不是PHP类,可以覆盖一个模板通过创建一个模板名称相同的模块(例如应用程序/工作/模板/ /后端模块目录工作管理模块):

最终的配置

最后配置Jobeet管理如下:

#应用/后端/模块/工作/ config /发电机。yml发生器:类:sfPropelGenerator参数:model_class: JobeetJob主题:管理non_verbose_templates:真正的with_show:虚假奇异:~复数:~ route_prefix: jobeet_job with_propel_route:真正的配置:行动:~:is_activated:{标签:激活?帮助:用户是否已激活的工作,或者不}is_public:{标签:公众吗?}列表:标题:作业管理布局:堆叠显示:[is_activated公司、位置、位置、url,电子邮件)参数:| % % is_activated % % <小> % % jobeet_category % % < /小>公司- % % % % (< em > % % % % < / em >邮件)正在寻找% % % % =位置(位置% % % %)max_per_page: 10: [expires_at, desc] batch_actions: _delete: ~扩展:~ object_actions:扩展:~ _edit: ~ _delete: ~行动:deleteNeverActivated:{标签:删除不激活工作}peer_method: doSelectJoinJobeetCategory过滤器:显示:[category_id添加,公司位置,描述、is_activated is_public,电子邮件,expires_at)形式:类:BackendJobeetJobForm显示:内容:[category_id添加、类型、公司标志、url位置,位置,描述,how_to_apply, is_public,电子邮件)管理:[_generated_token、is_activated expires_at)编辑:标题:编辑工作“% % % %公司寻找% % % %”新:标题:创造就业#应用/后端/模块/类别/ config /发电机。yml发生器:类:sfPropelGenerator参数:model_class: JobeetCategory主题:管理non_verbose_templates:真正的with_show:虚假奇异:~复数:~ route_prefix: jobeet_category with_propel_route:真正的配置:行动:~:~列表:标题:品类管理显示:[=名字,蛞蝓]batch_actions: {} object_actions:{}过滤器:类:虚假的形式:行动:_delete: ~ _list: ~ _save: ~编辑:标题:编辑类别“% % % %”新:标题:新类别

只有这两个配置文件,我们开发了一个伟大的后端接口Jobeet在几分钟内。

最终的想法

在短短一个小时,我们已经建立了一个功能齐全的后端接口Jobeet项目。总而言之,我们写了不到50行PHP代码。不太坏的很多功能!

明天,我们将看到如何安全的后端应用程序的用户名和密码。这也将是symfony的场合谈论用户类。ob娱乐下载