PHPAngular npm package

The simpliest way to angularise the world !

$3

$3

- EntityManager (like doctrine)
- User login
- Combine multiple get request into one
- Angular 2

$3

- [ ] Combine post request into one

$3

This website uses my library:
https://www.amelieferrari.fr
http://www.agencelessismore.fr

$3

#### Installation of the PHP Server application

First you have to setup the server side application : Installation PHPAngular PHP Side

#### PHPAngularisation !

Run the script

``

npm install phpangular --save

phpangular install

`

$3

The server side is in the "src" folder. Check https://github.com/emeric0101/PHPAngular/blob/master/README.md for how to use it.
Like in a Angular2 project, we have to create Component in the "app/Component" folder.
Your directory structure must be "app/Component/{MODULE}/{COMPONENT}". You can call {MODULE} and {COMPONENT} like you want but the class name must be {MODULE}{COMPONENT} (with camelcase !!).
Sample : "app/Component/Forum/Post", the class must be called "ForumPost". Except if the module and component have to same name, in this case, the class name is the module name : app/Component/Index/Index gives Index class.

PHPAngular need a index module in app/Component/Index/Index. So we will create a index component.
- Create all directories (app, Component, Index, Index).
- Create all files : Index.ts, Index.html
Open Index.html and put :
`HTML

Hello World!

`

Open Index.ts and put :
`Typescript

import { Component } from '@angular/core';
@Component({
templateUrl: 'app/Component/Index/Index/Index.html'
})
export class Index {

}

`

Then use
`
npm phpangular createRoute
npm start
`

##### Repository

`Typescript
// extract
import { Message } from '../../../Entity/Message';
import { UrlService } from 'phpangular/Service/url.service';
import { EntityManager } from 'phpangular/Service/entity.manager.service';
import { RepositoryService } from 'phpangular/Service/repository.service';
class Index {
message : Message = null;
messages : Message[] = [];
getMessage() {
this.$repo.findAll('Message', (messages) => {
this.messages = messages;
};
}
createMessage() {
this.message = new Message(this.$repo);
this.message.setTitle("test");
this.message.setDescription("test");
this.$em.persist(this.message);
this.$em.flush();
}
constructor(
private $url : UrlService,
private $em : EntityManager,
private $repo :RepositoryService
){

}
}

}
`
> The entityManager is like doctrine entityManager (so it automaticly persists all entities linked to)

> You can use MainController::message directly as ng-model in the template (ng-model="ctrl.message.title")

For using this controller into the template, you just need to call it with ng-controller="MainController as ctrl".

##### Custom query

You may use custom query to get entities from the server. The repository service permits you to do this by the method findSome
`Typescript
findSome(
method: string, // The method you want into the controller
name : string, // The controller to call in the server (MUST BE THE SAME NAME THAN THE ENTITY REQUESTED)
id: number, // Args to pass to the controller
params: any, // Get params to the controller (if id is not enough)
callback : (obj : any[]) => void, // callback to call after (because async)
error? : () => void
) {
`

In the controller (PHP) :
`PHP
public function someFunction($id = 0) {
if ($id == 0) {
$this->response->setError("missing id");
return false;
}
$message = $this->entityManager->find("TestVendor\TestBundle\Entity\Message", $id);
$this->response->setResponse('Message', $message);
}
`
Obviously, this method is useless because it does exactly the same as findById().

#### Angular module
You can use some angular modules by adding them into phpangularmodules (web/config.ts).
It is like doing angular.module('somemodule', phpangularmodules);

`javascript
var phpangularmodules = ['angular-file-upload', 'anguar-recaptcha'];
`

#### User loggin
##### Server side
You just have to create an entity which implement IUser (don't forget to extends EntityAbstract)
`PHP
namespace Emeric0101\PHPAngular\Entity;
use Emeric0101\PHPAngular\Entity\EntityAbstract;

interface IUser
{
public function setMail($mail);
public function getMail();


public function getPassword();
public function setHashedPassword(string $p);
}
``

PHPAngular provide login and logout method by the controller "Login". But you have to create the user subscribe yourself.
In Emeric0101\PHPAngular\Service\Login, you have some methods which help you to check user account.
For password hash, you can use Emeric0101\PHPAngular\Service\Login::hashPassword(string)

##### Client side
You have to implement IUser too (but the entity MUST be the same than the server !!!)
Like the server side, you have a Login service which provide you all methods you'll need for user login and logout.