Forem: Mete ARSLAN

Astro Internationalization With Dynamic Routing

Mete ARSLAN — Fri, 16 May 2025 07:08:04 +0000

Table of Contents

About The Project
- Built With
How To Implement
- Project Structure
- Translation Files
- Set Language Endpoint
- Language Middleware
- Disable Prerendering
- Add Dynamic Routing
- Add Components
- Call Set Language Endpoint
Resources
GitHub Link

About The Project

This project demonstrates an alternative approach to internationalization in Astro using dynamic routing and cookies. While disabling prerendering is not generally recommended, it is necessary on pages that rely on cookies for language detection. This method also doesn't prevent use of alternative translation methods.

You can also check libraries like astro-i18next, paraglide.

(back to top)

Built With

(back to top)

How To Implement

Project Structure

Configure Astro

First lets start with configuration. We have to define i18n settings. I used Turkish and English languages for my project and default locale for my website was Turkish. Also for this project Turkish language have been designated as fallback language.

Routing is set to manual. While options like prefixDefaultLocale are available, manual routing combined with middleware is easier to manage in this setup.

astro.config.mjs

import { defineConfig } from "astro/config";
import vue from "@astrojs/vue";
import tailwind from "@astrojs/tailwind";

// https://astro.build/config
export default defineConfig({
  i18n: {
    locales: ["tr", "en"],
    defaultLocale: "tr",
    fallback: {
      en: "tr",
    },
    routing: "manual",
  },
  integrations: [
    vue(),
    tailwind({
      applyBaseStyles: false,
    }),
  ],
});

Translation Files

After some configuration we have to create our translation methods and files. The functions are straightforward. We get translations from json files and from the url we decide which language to use.

src/translate/index.ts

import tr from "./tr.json";
import en from "./en.json";

export const supportedLangues = ["en", "tr"];
export const defaultLang = "tr";

export const translations = {
  en,
  tr,
} as const;

export function getLangFromUrl(url: URL) {
  const lang = url.pathname.split("/").at(1)!;
  if (lang in translations) return lang as keyof typeof translations;
  return defaultLang;
}

function useTranslations(lang: keyof typeof translations) {
  return function t(key: keyof (typeof translations)[typeof defaultLang]) {
    return key in translations[lang]
      ? (translations[lang] as any)[key]
      : translations[defaultLang][key];
  };
}

export function getTranslation(url: URL) {
  const lang = getLangFromUrl(url);
  return useTranslations(lang);
}

src/translate/en.json

{
  "hello": "Hello world"
}

Set Language Endpoint

To hold user language preference I used cookies. Create an endpoint to set language cookie.

src/pages/api/set-language.ts

import type { APIRoute } from "astro";

export const prerender = false;

export const POST: APIRoute = async ({ cookies, request }) => {
  const language = await request.text();

  cookies.set("language", language, {
    httpOnly: true,
    sameSite: "strict",
    path: "/",
  });

  return new Response("", { status: 200 });
};

Language Middleware

The middleware determines which endpoint the user should be redirected to. First we check language cookie to find if user has set a language. If cookie is undefined than we check preferredLocale from the request. If both language cookie and preferredLocale is undefined user will be redirected to default language.

You should also not interrupt the requests that are not require language redirection (Like API request, asset requests etc.). So we added ignorPath function.

src/middleware/index.ts

import { sequence } from "astro:middleware";
import { languageMiddleware } from "./language.middleware";

export const onRequest = sequence(languageMiddleware);

src/middleware/language.middleware.ts

import { defineMiddleware } from "astro:middleware";
import { redirectToDefaultLocale } from "astro:i18n"; // function available with `manual` routing
import { supportedLangues } from "../translate";

export const languageMiddleware = defineMiddleware((ctx, next) => {
  const pathName = ctx.url.pathname;

  if (ignorePath(pathName)) {
    return next();
  }

  let cookieLang = ctx.cookies.get("language")?.value;

  if (!cookieLang && ctx.preferredLocale) {
    cookieLang = ctx.preferredLocale;
  }

  if (cookieLang && supportedLangues.includes(cookieLang)) {
    return ctx.redirect(`/${cookieLang}/${pathName}`, 302);
  }

  return redirectToDefaultLocale(ctx, 302);
});

function ignorePath(pathName: string) {
  const ignoredPaths = [
    ...supportedLangues.map((lang) => `/${lang}`),
    "/api",
    "/assets",
    "/static",
    "/.",
  ];

  return ignoredPaths.some((ignoredPath) => pathName.startsWith(ignoredPath));
}

Disable Prerendering

You have to disable prerending in pages that you want to get language preference from cookies.

src/pages/index.astro

---
export const prerender = false;
---

Add Dynamic Routing

Finally we have to add dynamic routing for creating multiple versions of pages. Create a [locale] folder under the pages and add your other pages that requires translation.

src/pages/[locale]/index.astro

---
import Layout from "@pw/layouts/Layout.astro";

export const prerender = false;

export async function getStaticPaths() {
  return [{ params: { locale: "en" } }, { params: { locale: "tr" } }];
}
---

<Layout title="Mete ARSLAN" />

Add Components

I also added simple Layout.astro component for this project. There is a default slot for rendering page content and named slots for header, footer components.

src/layouts/Layout.astro

---
import DefaultFooter from "@pw/components/astro/footers/DefaultFooter.astro";
import DefaultHeader from "@pw/components/astro/headers/DefaultHeader.astro";
import "@pw/styles/main.scss";

interface Props {
  title: string;
}

const { title } = Astro.props;
---

<!doctype html>
<html lang="en">
  <head>
    <meta charset="UTF-8" />
    <meta name="description" content="Astro description" />
    <meta name="viewport" content="width=device-width" />
    <link rel="icon" type="image/svg+xml" href="/favicon.svg" />
    <meta name="generator" content={Astro.generator} />
    <title>{title}</title>
  </head>
  <body>
    <header>
      <slot name="header">
        <DefaultHeader />
      </slot>
    </header>
    <main>
      <slot />
    </main>
    <footer>
      <slot name="footer">
        <DefaultFooter />
      </slot>
    </footer>
  </body>
</html>

To get translation call getTranslation function that we have created and give page's url to it. For this example I also passed targetLanguage as a parameter to a vue component for being able to swap between the languages. You can also use other frameworks or simply add inline javascript to Astro components.

src/components/astro/headers/DefaultHeader.astro

---
import { LanguageSwapButton } from "@pw/vue-components";
import { getTranslation } from "@pw/translate";

const translate = getTranslation(Astro.url);

const currentLanguage =
  Astro.cookies.get("language")?.value || Astro.preferredLocale || "tr"; // Default to "tr" if cookie is not set
const targetLanguage = currentLanguage === "en" ? "tr" : "en";
---

<div>
  <LanguageSwapButton client:load targetLanguage={targetLanguage}>
    <pre>{translate('hello')}</pre>
  </LanguageSwapButton>
</div>

Call Set Language Endpoint

To change the language, send a request to /api/set-language.

src/components/vue/buttons/LanguageSwapButton.vue

<script lang="ts" setup>
import Button from "../shadcn/buttons/Button.vue";

const { targetLanguage } = defineProps({
  targetLanguage: {
    type: String,
    required: true,
  },
});

async function onClick() {
  await fetch(`/api/set-language`, {
    method: "POST",
    headers: { "Content-Type": "application/text" },
    body: targetLanguage,
  });

  window.location.href = "/" + targetLanguage;
}
</script>

<template>
  <Button variant="outline" size="sm" @click="onClick()">
    <slot />
  </Button>
</template>

(back to top)

Resources

(back to top)

GitHub Link

Group Policy Management Editor'ün Dosya Yapısının İncelenmesi

Mete ARSLAN — Sun, 16 Jan 2022 22:28:53 +0000

Group Policy Management Editor'ün Dosya Yapısının İncelenmesi

Group Policy Nedir?

Group Policy, Active Directory ortamında bulunan kullanıcı ve bilgisayarların konfigürasyonlarını kontrol etmemizi sağlayan Windows yönetim özelliğidir.

Group Policy ile bütün birimler, siteler ve domainler tek ve merkezi bir yerden kontrol edilebilinir. Bu özellik tek tek bütün bilgisayarların konfigürasyonu yapılmadığı için zaman kazandırır.

Group Policy Management Editor Nedir?

Group Policy Management Editor, kullanıcıların diğer bilgisayar ve kullanıcıların konfigürasyon politikalarını değiştirmesini sağlayan Windows yönetici aracıdır.

Kullanıcı ve Bilgisayar olarak ikiye ayrılır.

Dosya Yapısının İncelenmesi

Group Policy Management Editor oluşturulurken " C:\Windows\PolicyDefinitions" dizininin altındaki ".admx" uzantılı dosyalar ve dil dizininin altındaki ".adml" uzantılı dosyalar kullanılır.

Yapılan değişiklikler "C:\Windows\SYSVOL\domain\Policies{uniqueId}" dizininin altındaki "Machine" ve "Users" dizinlerindeki "Registry.pol" dosyasına kaydedilir.

".admx" Uzantılı Dosyaların İncelenmesi

<?xml version="1.0" encoding="utf-8"?>
<!--  (c) 2006 Microsoft Corporation  -->
<policyDefinitions xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" revision="1.0" schemaVersion="1.0" xmlns="http://schemas.microsoft.com/GroupPolicy/2006/07/PolicyDefinitions">
  <policyNamespaces>
    <target prefix="diskquota" namespace="Microsoft.Policies.DiskQuota" />
    <using prefix="windows" namespace="Microsoft.Policies.Windows" />
  </policyNamespaces>
  <resources minRequiredRevision="1.0" />
  <categories>
    <category name="DiskQuota" displayName="$(string.DiskQuota)">
      <parentCategory ref="windows:System" />
    </category>
  </categories>
  <policies>
    <policy name="DQ_Enable" clientExtension="{3610eda5-77ef-11d2-8dc5-00c04fa31a66}" class="Machine" displayName="$(string.DQ_Enable)" explainText="$(string.DQ_Enable_Help)" key="Software\Policies\Microsoft\Windows NT\DiskQuota" valueName="Enable">
      <parentCategory ref="DiskQuota" />
      <supportedOn ref="windows:SUPPORTED_Win2k" />
      <enabledValue>
        <decimal value="1" />
      </enabledValue>
      <disabledValue>
        <decimal value="0" />
      </disabledValue>
    </policy>
    <policy name="DQ_Enforce" clientExtension="{3610eda5-77ef-11d2-8dc5-00c04fa31a66}" class="Machine" displayName="$(string.DQ_Enforce)" explainText="$(string.DQ_Enforce_Help)" key="Software\Policies\Microsoft\Windows NT\DiskQuota" valueName="Enforce">
      <parentCategory ref="DiskQuota" />
      <supportedOn ref="windows:SUPPORTED_Win2k" />
      <enabledValue>
        <decimal value="1" />
      </enabledValue>
      <disabledValue>
        <decimal value="0" />
      </disabledValue>
    </policy>
    <policy name="DQ_Limit" class="Machine" displayName="$(string.DQ_Limit)" explainText="$(string.DQ_Limit_Help)" presentation="$(presentation.DQ_Limit)" key="Software\Policies\Microsoft\Windows NT\DiskQuota">
      <parentCategory ref="DiskQuota" />
      <supportedOn ref="windows:SUPPORTED_Win2k" />
      <elements>
        <decimal id="DQ_LimitValue" clientExtension="{3610eda5-77ef-11d2-8dc5-00c04fa31a66}" valueName="Limit" required="true" maxValue="1000" />
        <enum id="DQ_LimitUnits" clientExtension="{3610eda5-77ef-11d2-8dc5-00c04fa31a66}" valueName="LimitUnits" required="true">
          <item displayName="$(string.DQ_UnitsKB)">
            <value>
              <decimal value="1" />
            </value>
          </item>
          <item displayName="$(string.DQ_UnitsMB)">
            <value>
              <decimal value="2" />
            </value>
          </item>
          <item displayName="$(string.DQ_UnitsGB)">
            <value>
              <decimal value="3" />
            </value>
          </item>
          <item displayName="$(string.DQ_UnitsTB)">
            <value>
              <decimal value="4" />
            </value>
          </item>
          <item displayName="$(string.DQ_UnitsPB)">
            <value>
              <decimal value="5" />
            </value>
          </item>
          <item displayName="$(string.DQ_UnitsEB)">
            <value>
              <decimal value="6" />
            </value>
          </item>
        </enum>
        <decimal id="DQ_ThresholdValue" clientExtension="{3610eda5-77ef-11d2-8dc5-00c04fa31a66}" valueName="Threshold" required="true" maxValue="1000" />
        <enum id="DQ_ThresholdUnits" clientExtension="{3610eda5-77ef-11d2-8dc5-00c04fa31a66}" valueName="ThresholdUnits" required="true">
          <item displayName="$(string.DQ_UnitsKB)">
            <value>
              <decimal value="1" />
            </value>
          </item>
          <item displayName="$(string.DQ_UnitsMB)">
            <value>
              <decimal value="2" />
            </value>
          </item>
          <item displayName="$(string.DQ_UnitsGB)">
            <value>
              <decimal value="3" />
            </value>
          </item>
          <item displayName="$(string.DQ_UnitsTB)">
            <value>
              <decimal value="4" />
            </value>
          </item>
          <item displayName="$(string.DQ_UnitsPB)">
            <value>
              <decimal value="5" />
            </value>
          </item>
          <item displayName="$(string.DQ_UnitsEB)">
            <value>
              <decimal value="6" />
            </value>
          </item>
        </enum>
      </elements>
    </policy>
    <policy name="DQ_LogEventOverLimit" clientExtension="{3610eda5-77ef-11d2-8dc5-00c04fa31a66}" class="Machine" displayName="$(string.DQ_LogEventOverLimit)" explainText="$(string.DQ_LogEventOverLimit_Help)" key="Software\Policies\Microsoft\Windows NT\DiskQuota" valueName="LogEventOverLimit">
      <parentCategory ref="DiskQuota" />
      <supportedOn ref="windows:SUPPORTED_Win2k" />
      <enabledValue>
        <decimal value="1" />
      </enabledValue>
      <disabledValue>
        <decimal value="0" />
      </disabledValue>
    </policy>
    <policy name="DQ_LogEventOverThreshold" clientExtension="{3610eda5-77ef-11d2-8dc5-00c04fa31a66}" class="Machine" displayName="$(string.DQ_LogEventOverThreshold)" explainText="$(string.DQ_LogEventOverThreshold_Help)" key="Software\Policies\Microsoft\Windows NT\DiskQuota" valueName="LogEventOverThreshold">
      <parentCategory ref="DiskQuota" />
      <supportedOn ref="windows:SUPPORTED_Win2k" />
      <enabledValue>
        <decimal value="1" />
      </enabledValue>
      <disabledValue>
        <decimal value="0" />
      </disabledValue>
    </policy>
    <policy name="DQ_RemovableMedia" clientExtension="{3610eda5-77ef-11d2-8dc5-00c04fa31a66}" class="Machine" displayName="$(string.DQ_RemovableMedia)" explainText="$(string.DQ_RemovableMedia_Help)" key="Software\Policies\Microsoft\Windows NT\DiskQuota" valueName="ApplyToRemovableMedia">
      <parentCategory ref="DiskQuota" />
      <supportedOn ref="windows:SUPPORTED_Win2k" />
    </policy>
  </policies>
</policyDefinitions>

Yukarıda gördüğünüz "DiskQuota.admx" dosyasındandaki "policy/elements" altındaki tag'ler ile "Options" kısmı oluşturulmaktadır. Bu kısmda oluşacak girdi tipleri, girdilerin özellikleri gibi bilgiler bulunur. İstenilen ayarlar "key" ve "valueName" ile bulunabilinir. Bazı "policy" tag'lerinin altında elements bulunmamaktadır. Bu durumda "Options" kısmı oluşturulmaz. Alınan değer üste bulunan "Not Configured", "Enabled" yada "Disabled" butonları ile belirlenir.

".adml" Uzantılı Dosyaların İncelenmesi

<?xml version="1.0" encoding="utf-8"?>
<!--  (c) 2006 Microsoft Corporation  -->
<policyDefinitionResources xmlns:xsd="http://www.w3.org/2001/XMLSchema"
      xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" revision="1.0" schemaVersion="1.0"
      xmlns="http://schemas.microsoft.com/GroupPolicy/2006/07/PolicyDefinitions">
      <displayName>enter display name here</displayName>
      <description>enter description here</description>
      <resources>
            <stringTable>
                  <string id="DiskQuota">Disk Quotas</string>
                  <string id="DQ_Enable">Enable disk quotas</string>
                  <string id="DQ_Enable_Help">This policy setting turns on and turns off disk quota management on all NTFS volumes of the computer, and prevents users from changing the setting.

                        If you enable this policy setting, disk quota management is turned on, and users cannot turn it off.

                        If you disable the policy setting, disk quota management is turned off, and users cannot turn it on.

                        If this policy setting is not configured, disk quota management is turned off by default, but administrators can turn it on.

                        To prevent users from changing the setting while a setting is in effect, the system disables the "Enable quota management" option on the Quota tab of NTFS volumes.

                        Note: This policy setting turns on disk quota management but does not establish or enforce a particular disk quota limit. To specify a disk quota limit, use the "Default quota limit and warning level" policy setting. Otherwise, the system uses the physical space on the volume as the quota limit.

                        Note: To turn on or turn off disk quota management without specifying a setting, in My Computer, right-click the name of an NTFS volume, click Properties, click the Quota tab, and then click "Enable quota management."</string>
                  <string id="DQ_Enforce">Enforce disk quota limit</string>
                  <string id="DQ_Enforce_Help">This policy setting determines whether disk quota limits are enforced and prevents users from changing the setting.

                        If you enable this policy setting, disk quota limits are enforced. If you disable this policy setting, disk quota limits are not enforced. When you enable or disable this policy setting, the system disables the "Deny disk space to users exceeding quota limit" option on the Quota tab so administrators cannot make changes while the setting is in effect.

                        If you do not configure this policy setting, the disk quota limit is not enforced by default, but administrators can change the setting.

                        Enforcement is optional. When users reach an enforced disk quota limit, the system responds as though the physical space on the volume were exhausted. When users reach an unenforced limit, their status in the Quota Entries window changes, but they can continue to write to the volume as long as physical space is available.

                        Note: This policy setting overrides user settings that enable or disable quota enforcement on their volumes.

                        Note: To specify a disk quota limit, use the "Default quota limit and warning level" policy setting. Otherwise, the system uses the physical space on the volume as the quota limit.</string>
                  <string id="DQ_Limit">Specify default quota limit and warning level</string>
                  <string id="DQ_Limit_Help">This policy setting specifies the default disk quota limit and warning level for new users of the volume.

                        This policy setting determines how much disk space can be used by each user on each of the NTFS file system volumes on a computer. It also specifies the warning level, the point at which the user's status in the Quota Entries window changes to indicate that the user is approaching the disk quota limit.

                        This setting overrides new users’ settings for the disk quota limit and warning level on their volumes, and it disables the corresponding options in the "Select the default quota limit for new users of this volume" section on the Quota tab.

                        This policy setting applies to all new users as soon as they write to the volume. It does not affect disk quota limits for current users, or affect customized limits and warning levels set for particular users (on the Quota tab in Volume Properties).

                        If you disable or do not configure this policy setting, the disk space available to users is not limited. The disk quota management feature uses the physical space on each volume as its quota limit and warning level.

                        When you select a limit, remember that the same limit applies to all users on all volumes, regardless of actual volume size. Be sure to set the limit and warning level so that it is reasonable for the range of volumes in the group.

                        This policy setting is effective only when disk quota management is enabled on the volume. Also, if disk quotas are not enforced, users can exceed the quota limit you set. When users reach the quota limit, their status in the Quota Entries window changes, but users can continue to write to the volume.</string>
                  <string id="DQ_LogEventOverLimit">Log event when quota limit is exceeded</string>
                  <string id="DQ_LogEventOverLimit_Help">This policy setting determines whether the system records an event in the local Application log when users reach their disk quota limit on a volume, and prevents users from changing the logging setting.

                        If you enable this policy setting, the system records an event when the user reaches their limit. If you disable this policy setting, no event is recorded. Also, when you enable or disable this policy setting, the system disables the "Log event when a user exceeds their quota limit" option on the Quota tab, so administrators cannot change the setting while a setting is in effect.

                        If you do not configure this policy setting, no events are recorded, but administrators can use the Quota tab option to change the setting.

                        This policy setting is independent of the enforcement policy settings for disk quotas. As a result, you can direct the system to log an event, regardless of whether or not you choose to enforce the disk quota limit.

                        Also, this policy setting does not affect the Quota Entries window on the Quota tab. Even without the logged event, users can detect that they have reached their limit, because their status in the Quota Entries window changes.

                        Note: To find the logging option, in My Computer, right-click the name of an NTFS file system volume, click Properties, and then click the Quota tab.</string>
                  <string id="DQ_LogEventOverThreshold">Log event when quota warning level is exceeded</string>
                  <string id="DQ_LogEventOverThreshold_Help">This policy setting determines whether the system records an event in the Application log when users reach their disk quota warning level on a volume.

                        If you enable this policy setting, the system records an event. If you disable this policy setting, no event is recorded. When you enable or disable this policy setting, the system disables the corresponding "Log event when a user exceeds their warning level" option on the Quota tab so that administrators cannot change logging while a policy setting is in effect.

                        If you do not configure this policy setting, no event is recorded, but administrators can use the Quota tab option to change the logging setting.

                        This policy setting does not affect the Quota Entries window on the Quota tab. Even without the logged event, users can detect that they have reached their warning level because their status in the Quota Entries window changes.

                        Note: To find the logging option, in My Computer, right-click the name of an NTFS file system volume, click Properties, and then click the Quota tab.</string>
                  <string id="DQ_RemovableMedia">Apply policy to removable media</string>
                  <string id="DQ_RemovableMedia_Help">This policy setting extends the disk quota policies in this folder to NTFS file system volumes on removable media.

                        If you disable or do not configure this policy setting, the disk quota policies established in this folder apply to fixed-media NTFS volumes only. Note: When this policy setting is applied, the computer will apply the disk quota to both fixed and removable media.</string>
                  <string id="DQ_UnitsEB">EB</string>
                  <string id="DQ_UnitsGB">GB</string>
                  <string id="DQ_UnitsKB">KB</string>
                  <string id="DQ_UnitsMB">MB</string>
                  <string id="DQ_UnitsPB">PB</string>
                  <string id="DQ_UnitsTB">TB</string>***".adml"***
            </stringTable>
            <presentationTable>
                  <presentation id="DQ_Limit">
                        <text>Specify a quota limit and warning level applied to users when</text>
                        <text>they first write to a quota-enabled volume.</text>
                        <text></text>
                        <text>Default quota limit:</text>
                        <text></text>
                        <decimalTextBox refId="DQ_LimitValue" defaultValue="100" spinStep="10">Value</decimalTextBox>
                        <dropdownList refId="DQ_LimitUnits" noSort="true" defaultItem="1">Units</dropdownList>
                        <text></text>
                        <text>Default warning level:</text>
                        <text></text>
                        <decimalTextBox refId="DQ_ThresholdValue" defaultValue="100" spinStep="10">Value</decimalTextBox>
                        <dropdownList refId="DQ_ThresholdUnits" noSort="true" defaultItem="1">Units</dropdownList>
                  </presentation>
            </presentationTable>
      </resources>
</policyDefinitionResources>

Dikkat ettiyseniz ".admx" uzantılı dosyalarda editörde görmüş olduğunuz yazılar bulunmamaktadır. Bu yazılar seçilen dile göre oluşturulmuş olan ".adml" dosyalarında bulunur. ".adml" dosyasında bizim inceleyeceğimiz kısım "resources" tag'i altında bulunan tag'lerdir. "enum" gibi girdilerde "stringTable" altındaki "string"ler, "id" ler aracılığıyla bulunabilir ve ilgili kısmıdaki değerin karşılığı olan görsel ad olarak gösterilebilir(Örneğin "GB" olarak gördüğünüz giridnin karşılığı aslında "2" değeridir).

"presentationTable" altındaki "presentation" tagi bize options kısmındaki yazıları ve girdilerdeki bazı özellikleri belirtmektedir. İstenilen "presentation" id'ye göre seçilir ve refId'ler ".admx" uzantılı dosyalardaki id'ler ile eşleştirilerek "Options" kısmı oluşturulur.

"Registry.pol" Dosyasının İncelenmesi

"Registry.pol" dosyası yaptığımız değişikliklerin kaydedildiği dosyadır. Bu dosyadan her "Unique Id" için "Machine" ve "User" dosyaları altında birer adet bulunur. "Registry.pol" dosyası binrary formatında okunulması önerilse de basitçe "NotePad" kullanarak açıp okumayı deneyebilirsiniz.

b'PReg\x01\x00\x00\x00[\x00S\x00o\x00f\x00t\x00w\x00a\x00r\x00e\x00\\\x00P\x00o\xDataDirector00l\x00i\x00c\x00i\x00e\x00s\x00\\\x00M\x00i\x00c\x00r\x00o\x00s\x00o\x00f\x00t\x00\\\x00W\x00i\x00n\x00d\x00o\x00w\x00s\x00\\\x00W\x00i\x00n\x00d\x00o\x00w\x00s\x00 \x00S\x00e\x00a\x00r\x00c\x00h\x00\x00\x00;\x00D\x00a\x00t\x00a\x00D\x00i\x00r\x00e\x00c\x00t\x00o\x00r\x00y\x00\x00\x00;\x00\x01\x00\x00\x00;\x00\n\x00\x00\x00;\x00m\x00e\x00t\x00e\x00\x00\x00]\x00[\x00S\x00o\x00f\x00t\x00w\x00a\x00r\x00e\x00\\\x00P\x00o\x00l\x00i\x00c\x00i\x00e\x00s\x00\\\x00M\x00i\x00c\x00r\x00o\x00s\x00o\x00f\x00t\x00\\\x00W\x00i\x00n\x00d\x00o\x00w\x00s\x00 \x00N\x00T\x00\\\x00D\x00i\x00s\x00k\x00Q\x00u\x00o\x00t\x00a\x00\x00\x00;\x00L\x00i\x00m\x00i\x00t\x00\x00\x00;\x00\x04\x00\x00\x00;\x00\x04\x00\x00\x00;\x00d\x00\x00\x00]\x00[\x00S\x00o\x00f\x00t\x00w\x00a\x00r\x00e\x00\\\x00P\x00o\x00l\x00i\x00c\x00i\x00e\x00s\x00\\\x00M\x00i\x00c\x00r\x00o\x00s\x00o\x00f\x00t\x00\\\x00W\x00i\x00n\x00d\x00o\x00w\x00s\x00 \x00N\x00T\x00\\\x00D\x00i\x00s\x00k\x00Q\x00u\x00o\x00t\x00a\x00\x00\x00;\x00L\x00i\x00m\x00i\x00t\x00U\x00n\x00i\x00t\x00s\x00\x00\x00;\x00\x04\x00\x00\x00;\x00\x04\x00\x00\x00;\x00\x01\x00\x00\x00]\x00[\x00S\x00o\x00f\x00t\x00w\x00a\x00r\x00e\x00\\\x00P\x00o\x00l\x00i\x00c\x00i\x00e\x00s\x00\\\x00M\x00i\x00c\x00r\x00o\x00s\x00o\x00f\x00t\x00\\\x00W\x00i\x00n\x00d\x00o\x00w\x00s\x00 \x00N\x00T\x00\\\x00D\x00i\x00s\x00k\x00Q\x00u\x00o\x00t\x00a\x00\x00\x00;\x00T\x00h\x00r\x00e\x00s\x00h\x00o\x00l\x00d\x00\x00\x00;\x00\x04\x00\x00\x00;\x00\x04\x00\x00\x00;\x00d\x00\x00\x00]\x00[\x00S\x00o\x00f\x00t\x00w\x00a\x00r\x00e\x00\\\x00P\x00o\x00l\x00i\x00c\x00i\x00e\x00s\x00\\\x00M\x00i\x00c\x00r\x00o\x00s\x00o\x00f\x00t\x00\\\x00W\x00i\x00n\x00d\x00o\x00w\x00s\x00 \x00N\x00T\x00\\\x00D\x00i\x00s\x00k\x00Q\x00u\x00o\x00t\x00a\x00\x00\x00;\x00T\x00h\x00r\x00e\x00s\x00h\x00o\x00l\x00d\x00U\x00n\x00i\x00t\x00s\x00\x00\x00;\x00\x04\x00\x00\x00;\x00\x04\x00\x00\x00;\x00\x01\x00\x00\x00]\x00[\x00S\x00o\x00f\x00t\x00w\x00a\x00r\x00e\x00\\\x00P\x00o\x00l\x00i\x00c\x00i\x00e\x00s\x00\\\x00M\x00i\x00c\x00r\x00o\x00s\x00o\x00f\x00t\x00\\\x00W\x00i\x00n\x00d\x00o\x00w\x00s\x00 \x00N\x00T\x00\\\x00D\x00i\x00s\x00k\x00Q\x00u\x00o\x00t\x00a\x00\x00\x00;\x00E\x00n\x00a\x00b\x00l\x00e\x00\x00\x00;\x00\x04\x00\x00\x00;\x00\x04\x00\x00\x00;\x00\x00\x00\x00\x00]\x00'

Editorde değişiklik yaptıktan sonra dosyayı ikilik(binrary) formatında okutmayı denediğinizde yukarıdaki yazıya benzer bir yazı ile karşılaşacaksınız. İlk başta karışık gelse de okuması kolay bir formatta yazılmıştır.

Dosya "PReg\x01\x00\x00\x00" ifadesi ile başlar. Sonrasında "[]" içerisinde değerler yazılır. Aralıklara "\x00" biti konulur.

[\x00S\x00o\x00f\x00t\x00w\x00a\x00r\x00e\x00\\\x00P\x00o\x00l\x00i\x00c\x00i\x00e\x00s\x00\\\x00M\x00i\x00c\x00r\x00o\x00s\x00o\x00f\x00t\x00\\\x00W\x00i\x00n\x00d\x00o\x00w\x00s\x00\\\x00W\x00i\x00n\x00d\x00o\x00w\x00s\x00 \x00S\x00e\x00a\x00r\x00c\x00h\x00\x00\x00;\x00D\x00a\x00t\x00a\x00D\x00i\x00r\x00e\x00c\x00t\x00o\x00r\x00y\x00\x00\x00;\x00\x01\x00\x00\x00;\x00\n\x00\x00\x00;\x00m\x00e\x00t\x00e\x00\x00\x00]

Yazısı kaydedilen ilk değeri ifade etmektedir. Bu ifadede köşeli parentezleri atıp noktalı virgülle ayırıp "\x00"ları attığımızda:

Software\Policies\Microsoft\Windows\Windows Search
DataDirectory
\x01
\n
mete

Değerlei ortaya çıkar. İlk başta "NotePad" ile dosyası açtıysanız bu yazılara benzer yazılar görmüş olmalısınız. Ancak "\x01" yada "\n" gibi ifadeleri muhtemelen görememişsinizdir. Bunun nedeni "NotePad"'in bu karakterleri kullanıcının anlayacağı şekilde yorumlamaya çalışmasıdır. Şimdi bu değleri inceleyelim.

"Registry.pol" dosyasında her değer "\x00" byte'ı ile başlar. "Software\Policies\Microsoft\Windows\Windows Search" değeri politikamızın anahtarıdır. Bu anahtar aracılığı ile bu değerin hangi dizinde olduğu belirtilir.

"DataDirectory" değeri politikamızın id'sidir. Bu id aracılığıyla ".admx" ve ".adml" dosyalarındaki bize gerekli kısımları alabiliriz.

"\x01" veri tipini ifade eder. Ancak bu değeri tek başına bu şekilde almak değer 255'i geçince bizi hataya götürür. Tam sayı değerler dörder bit olarak okunmalıdır. "\x01\x00\x00\x00" şeklinde soldan sağa okuduğumuzda değerin ASCII karşılığında denk gelen sayıyı aldığımızda "1" değeri çıkar. Bu bize değer tipinin "REG_BINRARY" olduğunu gösterir(Karakter tipleri hakkında daha ayrıntılı bilgi için bu yazıyı okuyun.).

"\n\x00\x00\x00" değeri bize kaydedilen değerin boyutunu ifade eder. ASCII'de karşılığı "10"dur.

Son olarak "mete" değeri kaydedilen değerdir. Eğer karakter tipi "REG_BINRARY" değil "REG_DWORD" olsaydı karakter tipi yada boyutu gibi okumaya çalışacaktık.

Durum Değişiklikleri

Yaptığınız ayarı "Enabled" yada "Disabled" durumundan "Not Configured" durumuna getirip tekrar "Registry.pol" dosyasını okuduğunuzda o değerin silinmiş olduğunu görürsünüz. Bunun nedeni konfigüre edilmemiş ve varsayılan değerinde bulunan politikalarının kaydedilmemesidir.

"Disabled" durumunda da politika dosyaya yazılır. Ancak id'nin başına "\x00*\x00*\x00d\x00e\x00l\x00." ifade eklenir ve kaydedilen değer yerine boşluk yazılır. Tekrar "Enable" durmuna getirildiğinde "**del" ifadesi kalkar ve istenilen değer yazılır.

Liman Eklentilerinde Guzzle İle Express.js Web API'ına İstek Göndermek

Mete ARSLAN — Thu, 07 Oct 2021 11:49:58 +0000

Liman Eklentilerinde Guzzle İle Express.js Web API'ına İstek Göndermek

1- Express.js İle Web API'ın Hazırlanması

"liman" kullanıcısı ile liman sunucusuna bağlandıktan sonra "home/liman" dosyasına gidin.
Express.js kurulumunu yapın.

  express myapp

Komutu ile projenizi oluşturun.
Web App olarak kullanmayacağımız için "view" ve "public" dosyasını silin.
"routes" dosyasının users.js dosyasını da silebilirisiniz.
3000 numaralı portu kontrol edin. Eğer doluysa express.js çalışmayacaktır.
- Dolu olması durumunda enviroment değişkeninini değiştirerek yada "bin/www" dosyasında
```
var port = normalizePort(process.env.PORT || '3000');
```
3000 değeriyle oynayarak boş bir portta çalıştırın.(Doğru port ataması için Wikipedia'ya bakabilirsiniz.)
"app.js" dosyasında "view engine setup" "path" ve "userRouter"ın bulunduğu kısımları silin.
"error handler" kısmını tamamen silin yada başka bir hata kontrolü ekleyin.
Bittiğin de "app.js" aşağıdaki gibi görülecektir.

  var createError = require(anlamlı'http-errors');
  var express = require('express');
  var cookieParser = require('cookie-parser');
  var logger = require('morgan');

  var indexRouter = require('./routes/home');


  var app = express();



  app.use(logger('dev'));
  app.use(express.json());
  app.use(express.urlencoded({ extended: false }));
  app.use(cookieParser());wikipedia

  // `/home` yerine `/api/v1/users` gibi daha anlamlı isimler de verebilirsiniz. 
  app.use('/home', indexRouter);


  // catch 404 and forward to error handler
  app.use(function(req, res, next) {
    next(createError(404));
  });


  module.exports = app;

2- Kullanıcı İsimlerinin Eklenmesi ve Okunması

NOT: Bu örneğin basit tutulması için kullanıcılar veritabanında değil memory'de tutulmuştur

"routes" dizinin altında "home.js" dosyasında kullanıcı eklemek ve kullanıcıları almak için iki route ve bir array oluşturun oluşturun.

  var express = require('express');
  var router = express.Router();


  let names = [{
    name: "mete",
    surname: "arslan"
  },{
    name: "mehmet",
    surname: "basibuyuk"
  },{
    name: "ali",
    surname: "veli"
  }];


  router.get('/getNames', function (req, res, next) {
    res.send(JSON.stringify(names));
  });


  router.post('/addName', function (req, res, next) {
    console.log(req.body);konsolda
    if(!req.body.name || !req.body.surname)
      return res.send('FAILED').status(400);

    names.push(req.body);
    res.send("OK").status(200);
  });


  module.exports = router;

Kullanıcıları göndermeden önce karşı tarafta da kolay bir şekilde okunması için JSON formatına çevirip gönderin.
Gerçek projelerede "POST" işlemleri için "request" ile gönderilen bilgiye daha ayrıntılı bir doğrulama yapmanız gerekir. "express-validator" yada başka bir modül kullanabilirsiniz.
Bu işlemlerden sonra terminalden projenin olduğu dosyaya gidin ve

  npm run start

komutu ile uygulamanızı başlatın.

NOT:"Nodemon" yada benzeri bir modül ile çalıştırmaya başlarsanız yada uygulamayı kapatıp açarsanız kullanıcıların bulunduğu dizin memory'de olduğu için ilk duruma geri dönecektir.

3- Liman Eklentisinde Guzzle İle Controller Oluşturulması

Eklenti Oluşturulması:https://docs.liman.dev/eklenti-gelistirme/baslangic/yeni-eklenti-olusturma

Eklenti oluşturulduktan sonra(PHP OOP olarak oluşturun) VSCode ile "/liman/extensions/eklenti_adı" dosyasını açın.
composer.json dosyasında require kısmınıa Guzzle'i ekleyin

  eklemek"require": {
        "guzzlehttp/guzzle": "^7.0"
    }

"app/Controllers" altına bir controller oluşturun.

  <?php

  namespace App\Controllers;

  use Liman\Toolkit\Shell\Command;
  use GuzzleHttp\Client;


  class GuzzleTestController
  {
    private $client;

    public function __construct()
    {
        $this->$client = new Client([
            // Base URI is used with relative requests
            'base_uri' => '10.154.127.120:3001/',
            // You can set any number of default request options.
            'timeout'  => 2.0,
        ]);
    }


    public function getNames()
    {
        $response = $this->$client->request('GET', 'home/getNames');
        $contents = json_decode($response->getBody()->getContents());

        return respond($contents, 200);
    }


    public function addName()
    {
        validate([
            'name' => 'required|string',
            'surname' => 'required|string'
        ]);

        $body = json_encode(
            [
                'name' => request("name"),
                'surname' => request("surname")
            ]
        );


        $response = $this->$client->request(
            'POST',
            'home/addName',
            [
                'body' => $body,
                'headers' => ['Content-Type' => 'application/json']
            ]
        );

        $contents = $response->getBody()->getContents();

        return respond($contents, 200);
    }
  }

"constructor" kısmına oluşturmuş olduğumuz express serverına bağlanmak için bir client oluşturun.
Express.js'ten kullanıcıların bilgisini alacak ve kullanıcı ekleyecek iki metot yazın.
"getNames" metodunda istediğimiz kullanıcılar JSON formatında gelmektedir bu veriyi json_decode ile anlamlı hale getirip respond ile gönderin. Dilerseniz gelen veride bir sorun olması durumunda hata kontrolü de yaptırabilirsiniz.
"addName" metodunda kullanıcıdan da veri alınmaktadır. Alınan veri "validate" fonksiyonu ile doğrulandıktan sonra gönderinin "body" kısmına atamak için "request" fonksiyonunu kullanın.
"client" ile yapılacak olan istek için "$client->request()" metodunuda header kısmında gönderilen verinin JSON formatında olduğunu belirtin.
"response" Express tarafında işlemin başarılı yada başarısız olmasına göre bir dönüt verecektir.
Son olarak "routes.php" dosyasına yaptığınız metotları ekleyin.

  <?php
  eklemekeklemek
  return [
      "index" => "HomeController@index",

      "get_hostname" => "HostnameController@get",
      "set_hostname" => "HostnameController@set",

      "get_guzzletestnames" => "GuzzleTestController@getNames",
      "add_guzzletestnames" => "GuzzleTestController@addName"
  ];

4- View'in Kodlanması

NOT: Yetki problemlerinden dolayı yeni oluşturduğun dosyalar okunamayabiliyor. Oluşturduğunuz dosyaların sahibinin doğru kişi olduğundan emin olun.

"views" klasörünün altına yapmış olduğumuz Controller'ı çağaracak bir blade.php dosyası ve kodun daha düzenli olması için JsScript kodlarının bulunduğu dosyaları oluşturun.
index.blade.php dosyasına bu viewleri ekleyin.

  @extends('layouts.master')

  @section('content')
  <h2 class="text-bold">{{ __("Deneme2") }}</h2>

  <ul class="nav nav-tabs" role="tablist" style="margin-bottom: 15px;">
      <li class="nav-item">
          <a class="nav-link active" onclick="getHostname()" href="#hostname" data-toggle="tab">
              <i class="fas fa-server"></i> {{ __("Hostname") }}
          </a>
      </li>
      <li class="nav-item">
          <!--onclick kismina her guzzle test paneli sectildiginde tablonun yuklenmesi icin bir fonksiyon ekledim-->
          <a class="nav-link" onclick="guzzleTest()" href="#guzzleTest" data-toggle="tab">
              <i class="fas fa-server"></i> {{ __("Guzzle Test") }}
          </a>
      </li>
  </ul>

  <div class="tab-content">
      <div id="hostname" class="tab-pane active">
          @include('hostname.main')
      </div>
      <div id="guzzleTest" class="tab-pane">
          <!--burada oluşturmuş olduğum view'i ekledim-->
          @include('guzzleTest.main')
      </div>
  </div>
  @endsection

Oluşturmuş olduğunuz blade.php dosyasında tabloyu ve inputları alacak kısmı kodlayın ve son kısmında yazacağımız scriptleri de ekleyin.

  <div class="row">
      <div class="col-12 mb-2">
          <table id="users" class="table"></table>
      </div>
      <div class="col-12 mb-2">
          <form onsubmit="addName(); return false;" class="row input-group">
              <div class="col-md-4">
                  <input id="nameInput" type="text" class="form-control"/>
              </div>
              <div class="col-md-4">
                  <input id="surnameInput" type="text" class="form-control"/>
              </div>
              <div class="col-md-4">
                  <button type="submit" id="addNameButton" class="btn btn-warning">Kullanici Ekle</button>
              </div>
          </form>
      </div>
  </div>

  @include("guzzleTest.scripts")

<script>
    function getNames() {
        showSwal("{{ __('Yükleniyor...') }}", 'info');
        let data = new FormData();

        request("{{ API('get_guzzletestnames') }}", data, function(response) {
            response = JSON.parse(response);

            let users = response.message;

            let final_html = `<thead><tr>
                <th>Isim</th>
                <th>Soyisim</th>
            </tr></thead><tbody>`;

            users.forEach(u => {
                final_html += `<tr>
                <td>${u.name}</td>
                <td>${u.surname}</td>
                </tr>`
            });

            final_html += "</tbody>"

            $('#users').html(final_html);

            Swal.close();
        }, function(response) {
            response = JSON.parse(response);
            showSwal(response.message, 'error');
        });
    }


    function addName() {
        let data = new FormData();
        let $nameInput = $("#nameInput");
        let $surnameInput = $("#surnameInput");

        data.append("name", $nameInput.val());
        data.append("surname", $surnameInput.val());



        request("{{ API('add_guzzletestnames') }}", data,
            function(response) {
                response = JSON.parse(response);
                if(response.status == 200){
                    getNames();
                    $nameInput.val("");
                    $surnameInput.val("");
                }
            });
    }

-
    function guzzleTest() {
        getNames();
    }
</script>

Sciptlerin bulunacağı dosya içeriginde panel aktive olduğunda çağırılacak bir fonksiyon yazın.(Bu durumda bu fonksiyon guzzleTest)
Controller içerisinde yazmış olduğumuz metotları çağıracak iki fonksiyon yazın.
Bu fonksiyonlardan "getNames" kullanıcı listesini alıp tablo haline çeviriyor.
Controller'a istek göndermek için request fonksiyonu kullanılıyor. Eğer göndereciğiniz istekte veri varsa FormData sınıfından türemiş bir nesne ile ile ekleyip gönderin.

  data.append("name", $nameInput.val());
  data.append("surname", $surnameInput.val());

Github Linkleri

https://github.com/White-Hare/LimanGuzzleExpressOrnegi-Laravel

https://github.com/White-Hare/LimanGuzzleExpressOrnegi-Express